Skip to main content
Glama
powerpoint-mcp-live

powerpoint-mcp-live

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.py

Client 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_open_presentations

List every presentation open in PowerPoint

get_presentation_info

Slide count, per-slide titles, active slide

save_presentation

Save in place (Ctrl+S)

Slides

list_slides

List slide indexes and titles

add_slide

Add a slide with a chosen layout

delete_slide

Delete a slide

duplicate_slide

Duplicate a slide, inserted right after the original

move_slide

Reorder a slide to a new position

activate_slide

Make a slide the visible one in the PowerPoint window

Shapes & text

list_shapes

List shapes on a slide (name, type, position, text)

get_slide_text

Read a slide's title and all body text

add_textbox

Add a text box at a given position

set_shape_text

Set the text of an existing shape/placeholder

delete_shape

Delete a shape

set_shape_position

Move and/or resize a shape

Formatting

format_shape_text

Bold/italic/underline, font, size, color

format_shape

Fill color, outline color, outline weight

Speaker notes

get_speaker_notes

Read a slide's speaker notes

set_speaker_notes

Replace a slide's speaker notes

Export

export_slide_to_image

Export a slide to PNG/JPG/BMP/GIF for visual verification

Comments

add_comment

Add a slide comment (PowerPoint 2016+)

get_comments

List comments on a slide

delete_comment

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 tools
activate_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 CommentA
Destructive

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 ShapeA
Destructive

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 SlideA
Destructive

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 ImageA
Read-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 CommentsA
Read-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 InfoA
Read-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 TextA
Read-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 NotesA
Read-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 PresentationsA
Read-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 ShapesA
Read-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 SlidesA
Read-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

    A4/5.0

    Scored across 23 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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'.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers