ChatPPT MCP server
io.github.ParkerDiamond/chatppt·v0.2.0Model Context Protocol (MCP) server for programmatic PowerPoint creation and editing
0 stars480 downloads/wk
Reviews
Write oneNobody has reviewed ChatPPT yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
ChatPPT tools (26, 12 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
deck_createwrite actionCreate a new blank PowerPoint presentation deck and initialize its metadata in the managed workspace.
deck_deletewrite actionPermanently delete a presentation deck and its underlying PowerPoint file.
deck_importImport an existing PowerPoint deck into the managed workspace and initialize its registry metadata.
deck_listList all managed PowerPoint decks in the workspace.
deck_readRead metadata, slide list, and slide collections for a specific deck.
deck_updatewrite actionUpdate metadata or title of an existing presentation deck.
deck_validateValidate presentation deck integrity, checking PPTX file synchronization, collection slide references, and element geometry.
element_createwrite actionCreate one or multiple elements (text boxes, shapes, lines, tables, charts, or images) on a slide in a single batch operation.
element_deletewrite actionPermanently delete one or more elements from a slide in batch.
element_listList all visual elements on a slide in z-index order.
element_readRead details and formatting properties of a single element on a slide.
element_reorderReorder an element's z-index on a slide (bringToFront, sendToBack, bringForward, sendBackward).
element_updatewrite actionUpdate positioning, sizing, text, fill, typography, stroke, or alignment for one or multiple elements on a slide in batch.
slide_collection_createwrite actionCreate a named ordered collection/group of existing slides within a presentation deck.
slide_collection_deletewrite actionDelete a slide collection without deleting its referenced slides.
slide_collection_listList all slide collections in a presentation deck.
slide_collection_readRead details and slide ID membership of a specific slide collection.
slide_collection_updatewrite actionRename a slide collection, update its description, or replace its ordered slide membership.
slide_createwrite actionCreate one or multiple new slides in a presentation deck. Pass an array of slide definitions for vectorized batch creation.
slide_deletewrite actionPermanently delete one or more slides from the presentation and registry, and clean up collection references.
slide_duplicateDuplicate an existing slide in a presentation deck, generating new stable IDs for the slide and all duplicated elements.
slide_listList all slides in a presentation deck in presentation order.
slide_moveReorder slides in a presentation deck, either by providing a complete slideOrder array or moving a single slideId to a target position.
slide_readRead metadata, elements, and speaker notes for a specific slide.
slide_renderRender a slide to a PNG image preview for visual feedback.
slide_updatewrite actionUpdate metadata, title, or speaker notes of one or more slides in batch.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan18 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How ChatPPT compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 4,461 AI and agents servers
- Tools
- 26
- the typical AI and agents server has 6
- Tools that change things
- 46%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 480
- more than 86% of 1,554 AI and agents servers with a package
What its tools let an agent do: 14 read · 12 change
Release history: 2 versions in the registry since 2026-09-13, latest 2026-09-28, typically one every 14 days.
Install ChatPPT in Claude Code, Cursor or VS Code
Runs npx -y @jparkerdiamond/chatppt on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add chatppt -- npx -y @jparkerdiamond/chatppt
What the publisher says
From the ChatPPT repository's README, as published. We do not edit it. Read it on GitHub
ChatPPT
ChatPPT is a Model Context Protocol (MCP) server for programmatic, AI-assisted PowerPoint creation and editing. Built on Node.js 20+ and @office-kit/pptx, ChatPPT exposes a safe, structured, resource-oriented CRUD API over stdio for connected LLMs in Visual Studio Code and other MCP-compatible clients.
Key Features
- Stable Opaque IDs: Every presentation deck, slide, slide collection, and slide element is tracked with a stable UUID.
- Dual Storage Model:
- Presentation files are stored under presentations/.pptx.
- Server metadata, slide collections, and element mapping are tracked in .chatppt/registry.json.
- Atomic Operations & Consistency: All file writes use temporary files and atomic renames to prevent partial file corruption.
- Visual Slide Previews: Render any slide to a PNG image for agent visual feedback using @office-kit/pptx-preview.
- Vectorized / Batch Operations: Create, update, or delete multiple slides or elements in a single tool call to optimize LLM interactions.
- Rich Elements: Create and update text boxes, preset shapes (180+ DrawingML geometries), lines, tables, charts (column, bar, line, pie, doughnut, area), and images.
- Full Typography & Styling: Custom fonts, font sizes, bold, italic, text colors, fills, borders/strokes, alignment, and z-index ordering.
Installing & Configuring in VS Code
Option 1: Workspace MCP Configuration (.vscode/mcp.json)
To use ChatPPT in your VS Code workspace, add or update .vscode/mcp.json in the root of your workspace:
{
"servers": {
"chatppt": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/dist/index.js"]
}
}
}Option 2: Published Package or npx Execution
When running via npx or published binary, ChatPPT can be configured to target a specific workspace using the --workspace flag or environment variables:
{
"servers": {
"chatppt": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@jparkerdiamond/chatppt", "--workspace", "${workspaceFolder}"]
}
}
}Workspace Behavior & Security Boundaries
ChatPPT operates on a deterministic workspace root resolved in the following priority order:
- Command line argument: --workspace or -w
- Environment variable: CHATPPTWORKSPACEROOT or WORKSPACE_ROOT
- Fallback: process.cwd() (current working directory)
Files & Directories Managed
- Presentations: /presentations/.pptx
- Registry & Metadata: /.chatppt/registry.json
Security & Trust Boundaries
- Path Isolation: All deck paths, temporary write buffers, and image element paths are strictly checked to ensure they reside within the configured workspace.
- Path Traversal Protection: Deck IDs must match ^[a-zA-Z0-9_-]+$. Absolute paths or relative paths attempting directory traversal (..) outside the workspace root are caught and rejected with ValidationError.
Known Limitations
- Encrypted Presentations: Encrypted or password-protected .pptx presentations are detected and rejected.
- Master / Theme Layout Authoring: Slide creation uses layouts built into the deck template; creating custom slide master themes from scratch is deferred to post-1.0.
Available MCP Tools
Deck Management (deck_*)
- deck_create: Create a new blank presentation deck.
- deck_list: List all managed decks in the workspace.
- deck_read: Read metadata and slide/collection list for a deck.
- deck_update: Update deck metadata (title) with optional optimistic revision check (expectedRevision).
- deck_delete: Permanently delete a deck and its .pptx file.
- deck_validate: Run diagnostic invariant checks across PPTX content and registry metadata.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
ChatPPT: common questions
- Is ChatPPT MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the ChatPPT safety report
- How do I install ChatPPT?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does ChatPPT need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is ChatPPT maintained?
- The last commit was 39 days ago (2026-09-28). The latest release is v0.2.0.
- What can I use instead of ChatPPT?
- Servers from other publishers that do the same job: Serena MCP: the IDE for your agent MCP server and Image MCP server.
- How does ChatPPT compare with other AI and agents MCP servers?
- safety score 92/100 (higher than 90% of 4,461 AI and agents servers); tools 26 (the typical AI and agents server has 6); tools that change things 46% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to ChatPPT
Same job from other publishers: the closest match first, then the best rated.
- Serena MCP: the IDE for your agentA powerful toolkit for coding, providing semantic retrieval and editing capabilities.not reviewedWidely usedC
- ImageAI image generation and editing with prompt optimization and quality presetsnot reviewedEstablishedB