About pptx-mcp
pptx-mcp is an open-source MCP server for AI agents that need to inspect PowerPoint files. It extracts slide text, retrieves an embedded cover thumbnail, and creates an HTML preview of the first five slides; it does not render layouts or animations.
Key features
- 01Extract slide text and speaker notes
- 02Create JSON slide outlines
- 03Retrieve embedded cover thumbnails
- 04Build HTML previews of five slides
- 05Accept local paths or HTTP(S) sources
Use cases
- 01Reviewing received PowerPoint decks
- 02Collecting deck cover images
- 03Creating shareable text previews
MCP support
As an MCP server, it exposes tools for PowerPoint outlines, thumbnails, and web previews to AI agents.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
3Saved tool list · updated 5d ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| source | string | Yes | Local path or http(s) URL of a .pptx file |
Details
From the project READMEpptx-mcp
Read, outline and preview PowerPoint (.pptx) files from any AI agent. Free and open source (MIT) Model Context Protocol server by 207studio.
What it does
| Tool | What you get |
|---|---|
pptx_outline | A slide-by-slide outline of the deck as JSON: title, body text and speaker notes. |
pptx_thumbnail | The cover thumbnail PowerPoint saved inside the file, when the file has one. |
pptx_web_preview | A self-contained HTML page showing the first 5 slides as text cards, ready to share. |
source can be a local path or an http(s) URL. Files up to 50 MB.
Install
{
"mcpServers": {
"pptx": { "command": "npx", "args": ["-y", "github:207studio/pptx-mcp"] }
}
}
Or clone and run npm install && node src/index.js (Node 18+).
Bot ideas
- Deck summarizer: outline a .pptx you got by email and draft a reply.
- Cover gallery: pull the cover thumbnail of every deck in a folder.
- Share preview: turn a deck into one HTML page you can share as a link.
Need real slides in your own app?
pptx-mcp reads text only. It does not render layouts, images, animations or transitions.
To play .pptx files inside your web app with layout, animations and transitions, use PPTX Player SDK. It is a one-time purchase with source included.
Development
npm install
npm test
MCPB bundle
npm ci
npm run bundle
Upload dist/pptx-mcp.mcpb to Smithery as "Local (MCPB Bundle)". The bundle includes production dependencies.
License
MIT © 207studio
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.