powerpoint-mcp-live
Manage an already-open PowerPoint presentation in place (Windows/COM), without launching or closing PowerPoint.
Presentations: list open decks, get slide/title/active-slide info, and save in place.
Slides: list, add with layouts, delete, duplicate, reorder, and activate slides.
Shapes/text: list shapes, read slide text, add text boxes, set shape text, delete shapes, move/resize shapes.
Formatting: bold/italic/underline, font name/size/color, fill color, outline color/weight.
Speaker notes: read and replace notes.
Export: export a slide to PNG/JPG/BMP/GIF for visual verification.
Comments: add, list, and delete slide comments (PowerPoint 2016+).
Scope/limits: requires Windows and PowerPoint running with a presentation open; no tables, charts, SmartArt, animations, transitions, templates/themes, or single-step undo grouping.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@powerpoint-mcp-live Add a text box on slide 3 that says 'URGENT' in red."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
powerpoint-mcp-live
Edit a PowerPoint presentation while it's open — the AI attaches to the window you already have, it doesn't start its own.
Live editing · Windows (COM) · 23 tools
Most PowerPoint MCP servers (including this workspace's own mcp-server-powerpoint) work by starting a fresh, invisible PowerPoint process, opening your file in it, and closing it again when done. That's great for scripted deck generation, but it means the AI is never looking at the same window you are.
powerpoint-mcp-live does the opposite: it attaches to whatever PowerPoint window you already have
open via COM, using the same "find the running application" approach as
word-mcp-live and excel-mcp-live. It never launches
PowerPoint and never closes it — it only touches presentations you opened yourself.
Requirements
Windows (COM automation is Windows-only — there is no macOS/Linux mode for this project)
Microsoft PowerPoint installed and already running with a presentation open
Python 3.11+
Related MCP server: PowerPoint MCP Server
Installation
git clone <this-repo-url>
cd powerpoint-mcp-live
pip install -e .Or run straight from source with uv — no install step needed:
uv run powerpoint_mcp_server.pyClient setup (.mcp.json)
Point your MCP client at the project directory. For Claude Code, add this to .mcp.json in your
project (or ~/.claude.json for a user-wide config):
{
"mcpServers": {
"powerpoint-live": {
"command": "uv",
"args": [
"--directory",
"G:/Ai/MCP/powerpoint-mcp-live",
"run",
"powerpoint_mcp_server.py"
],
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}If you installed it with pip install -e . instead, you can use the console script directly:
{
"mcpServers": {
"powerpoint-live": {
"command": "powerpoint-mcp-live",
"env": {
"MCP_AUTHOR": "Your Name",
"MCP_AUTHOR_INITIALS": "YN"
}
}
}
}MCP_AUTHOR / MCP_AUTHOR_INITIALS set the author name/initials attached to new slide comments
(default: "Author" / "").
Limit tool discovery
Set POWERPOINT_MCP_TOOLSETS in the server's env to a comma-separated list of groups to register
only those tools, e.g. "POWERPOINT_MCP_TOOLSETS": "slides,shapes". Groups are combined as a
union. Available groups are presentations, slides, shapes (shapes and text), formatting,
notes, export and comments, matching the sections of the table below. Each tool is in exactly
one group. list_open_presentations is always registered. Unset, empty or all registers every
tool. An unknown group name stops the server at startup. Restart the server after changing this
setting. Filtering only controls which tools are listed and callable. It is not a security
boundary.
Supported functions
Every tool operates on a presentation that's already open in PowerPoint. presentation is
optional almost everywhere — omit it to target the active presentation.
Tool | Description |
Presentation | |
| List every presentation open in PowerPoint |
| Slide count, per-slide titles, active slide |
| Save in place (Ctrl+S) |
Slides | |
| List slide indexes and titles |
| Add a slide with a chosen layout |
| Delete a slide |
| Duplicate a slide, inserted right after the original |
| Reorder a slide to a new position |
| Make a slide the visible one in the PowerPoint window |
Shapes & text | |
| List shapes on a slide (name, type, position, text) |
| Read a slide's title and all body text |
| Add a text box at a given position |
| Set the text of an existing shape/placeholder |
| Delete a shape |
| Move and/or resize a shape |
Formatting | |
| Bold/italic/underline, font, size, color |
| Fill color, outline color, outline weight |
Speaker notes | |
| Read a slide's speaker notes |
| Replace a slide's speaker notes |
Export | |
| Export a slide to PNG/JPG/BMP/GIF for visual verification |
Comments | |
| Add a slide comment (PowerPoint 2016+) |
| List comments on a slide |
| Remove a comment |
Not yet covered: tables, charts, SmartArt, animations, transitions, templates/themes — for those, use mcp-server-powerpoint, which starts its own PowerPoint instance and has much broader operation coverage.
Example prompts
"I have this deck open — read the text on slide 3 and tell me if the bullets are too long."
"Add a new slide after slide 2 with a blank layout."
"Add a text box on slide 4 that says 'Draft — do not distribute' in red."
"Make the title on slide 1 bold and increase it to 44pt."
"Export slide 5 as an image so I can check whether anything overlaps."
"Add a comment on slide 3 asking if the chart numbers are up to date."Known limitations
Windows only. PowerPoint COM automation doesn't exist on macOS/Linux.
The presentation must already be open in PowerPoint. This server doesn't create or open files — see mcp-server-powerpoint for that.
No single-undo grouping. Word's COM API can wrap several edits into one Ctrl+Z; PowerPoint's cannot (neither can Excel's). A tool call that performs multiple writes may need several Ctrl+Z's to fully undo.
Comments require PowerPoint 2016+ (modern threaded comments).
Development
See CLAUDE.md for architecture notes and design constraints — in particular, why this server must never launch or quit PowerPoint itself.
Available Tools
23 toolsactivate_slideActivate SlideA
Make a slide the visible slide in PowerPoint's active window.
Args: presentation: Presentation name or path (None = active presentation). index: 1-based slide index (required).
Returns: JSON confirmation.
Inputs: index, presentation.
add_commentAdd CommentA
Add a comment to a slide (PowerPoint 2016+ modern comments).
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). text: Comment text (required). left, top: Position of the comment marker, in points. author: Comment author (default: MCP_AUTHOR env var, or "Author"). author_initials: Author initials (default: MCP_AUTHOR_INITIALS env var).
Returns: JSON confirmation.
Inputs: top, left, text, author, +3 more.
add_slideAdd SlideA
Add a new slide to an open presentation.
Args: presentation: Presentation name or path (None = active presentation). index: 1-based position to insert at (None = append at the end). layout: One of "title", "text", "two_content", "title_only", "blank" (default: "text").
Returns: JSON with the new slide's index.
Inputs: index, layout, presentation.
add_textboxAdd Text BoxA
Add a text box to a slide.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). text: Text content. left, top, width, height: Position and size in points.
Returns: JSON with the new shape's name and 1-based index on the slide.
Inputs: top, left, text, width, +3 more.
delete_commentDelete CommentADestructive
Delete a comment from a slide.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). index: 1-based comment index, from get_comments (required).
Returns: JSON confirmation.
Inputs: index, slide_index, presentation.
delete_shapeDelete ShapeADestructive
Delete a shape from a slide.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). shape: Shape name, or its 1-based index on the slide (required).
Returns: JSON confirmation.
Inputs: shape, slide_index, presentation.
delete_slideDelete SlideADestructive
Delete a slide from an open presentation.
Args: presentation: Presentation name or path (None = active presentation). index: 1-based slide index (required).
Returns: JSON confirmation.
Inputs: index, presentation.
duplicate_slideDuplicate SlideA
Duplicate a slide, inserting the copy immediately after the original.
Args: presentation: Presentation name or path (None = active presentation). index: 1-based slide index to duplicate (required).
Returns: JSON with the new slide's index.
Inputs: index, presentation.
export_slide_to_imageExport Slide to ImageARead-only
Export a slide to an image file for visual verification.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). output_path: Destination file path (required). Extension selects the format: .png, .jpg, .bmp, or .gif. width, height: Output image dimensions in pixels.
Returns: JSON with the exported file's absolute path. A vision-capable assistant can read the image back to check for overlapping shapes, text overflow, or layout regressions after an edit.
Inputs: width, height, output_path, slide_index, +1 more.
format_shapeFormat ShapeA
Format a shape's fill and outline.
Only arguments that are explicitly set are changed.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). shape: Shape name, or its 1-based index on the slide (required). fill_color: Hex RGB fill color, e.g. "4472C4" (with or without '#'). line_color: Hex RGB outline color. line_weight: Outline weight in points.
Returns: JSON confirmation.
Inputs: shape, fill_color, line_color, line_weight, +2 more.
format_shape_textFormat Shape TextA
Format the text of a shape (font style, name, size, color).
Only arguments that are explicitly set are changed.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). shape: Shape name, or its 1-based index on the slide (required). bold, italic, underline: Font style toggles. font_name: e.g. "Calibri". font_size: Point size. font_color: Hex RGB, e.g. "FF0000" (with or without leading '#').
Returns: JSON confirmation.
Inputs: bold, shape, italic, font_name, +5 more.
get_commentsGet CommentsARead-only
List all comments on a slide.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required).
Returns: JSON with each comment's 1-based index, author, text, and position.
Inputs: slide_index, presentation.
get_presentation_infoGet Presentation InfoARead-only
Get slide count, per-slide titles, and the active slide for an open presentation.
Args: presentation: Presentation name or path (None = active presentation).
Returns: JSON with each slide's index, title text (if it has a title placeholder), and layout.
Inputs: presentation.
get_slide_textGet Slide TextARead-only
Read all text on a slide — the title plus every other text-bearing shape.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required).
Returns: JSON with the title and a list of body text strings, in shape order.
Inputs: slide_index, presentation.
get_speaker_notesGet Speaker NotesARead-only
Read the speaker notes for a slide.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required).
Returns: JSON with the notes text (empty string if there are none).
Inputs: slide_index, presentation.
list_open_presentationsList Open PresentationsARead-only
List all presentations currently open in PowerPoint.
Returns: JSON with each presentation's name, full path, save state, slide count, and whether it's the active presentation.
Inputs: no named parameters.
list_shapesList ShapesARead-only
List shapes on a slide with name, type, position, and text (if any).
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required).
Returns: JSON with each shape's 1-based index, name, MsoShapeType, position/ size (points), and text.
Inputs: slide_index, presentation.
list_slidesList SlidesARead-only
List slides in an open presentation, with index and title text.
Args: presentation: Presentation name or path (None = active presentation).
Returns: JSON with each slide's index and title (if it has one).
Inputs: presentation.
move_slideMove SlideB
Move a slide to a new position in the slide order.
Args: presentation: Presentation name or path (None = active presentation). index: Current 1-based slide index (required). new_index: Target 1-based position (required).
Returns: JSON confirmation.
Inputs: index, new_index, presentation.
save_presentationSave PresentationA
Save an open presentation in place (equivalent to pressing Ctrl+S).
Args: presentation: Presentation name or path (None = active presentation).
Returns: JSON confirmation.
Inputs: presentation.
set_shape_positionSet Shape PositionA
Move and/or resize a shape. Only provided arguments are changed.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). shape: Shape name, or its 1-based index on the slide (required). left, top, width, height: New position/size in points (None = unchanged).
Returns: JSON with the shape's resulting position and size.
Inputs: top, left, shape, width, +3 more.
set_shape_textSet Shape TextB
Set the text of an existing shape (title, placeholder, or text box).
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). shape: Shape name, or its 1-based index on the slide (required). text: New text content.
Returns: JSON confirmation.
Inputs: text, shape, slide_index, presentation.
set_speaker_notesSet Speaker NotesA
Set the speaker notes for a slide, replacing any existing notes.
Args: presentation: Presentation name or path (None = active presentation). slide_index: 1-based slide index (required). text: New notes text.
Returns: JSON confirmation.
Inputs: text, slide_index, presentation.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Each tool targets a distinct resource-action combination: presentations, slides, shapes, text, notes, comments, and export. Even closely related tools like get_presentation_info vs list_slides are clearly differentiated—one provides overall slide metadata, the other a simple index/title list—while format_shape_text vs format_shape separate text styling from fill/outline.
All tool names follow a consistent snake_case verb_noun pattern: list_*, get_*, save_*, add_*, delete_*, duplicate_*, move_*, activate_*, set_*, format_*, export_*. No mixed conventions or vague verbs like 'process' or 'execute'.
23 tools is slightly over the typical sweet spot of 3–15, but the count is justified by the comprehensive breadth of PowerPoint automation (presentations, slides, shapes, notes, comments, export). Each tool serves a distinct purpose with no redundant or filler tools, making the scope reasonable for a mature MCP server.
The tool surface covers the full lifecycle of working with presentations, slides, shapes, notes, and comments, including read, create, update, delete, and navigation operations. The main gap is the lack of open/close/presentation creation tools—it only operates on already-open presentations—but this is a design limitation rather than an oversight, and the existing coverage handles all in-session edits.
Maintenance
Related MCP Connectors
Generate, edit, merge, translate and PDF-convert PowerPoint (.pptx) over MCP. 8 tools.
Create, edit, export and manage presentations. Requires a paid PPT.AI API merchant account.
Read and update slide text and structure in owned AppStruct presentations.
Turn notes into slides, edit presentations, compare designs, and export HTML or PowerPoint.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables AI assistants to create, edit, and manipulate PowerPoint presentations programmatically with support for text styling, shapes, slide rearrangement, and direct Office XML access.81-
- AlicenseNot gradedqualityDmaintenanceEnables PowerPoint automation on Windows, including template-based creation, real-time editing, LaTeX equations, animations, and multimodal slide analysis, all via natural language.142 PyPI127MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to create, inspect, and edit PowerPoint presentations programmatically using tools for slides, text, shapes, images, tables, and search-and-replace operations.-
- AlicenseAqualityBmaintenanceEnables creating and editing PowerPoint .pptx files without corruption, with native editable SVG shapes, glued connectors, table surgery, threaded comments, live editing, and a comprehensive 138-tool MCP server surface.92AGPL 3.0