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.

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.

Save an open presentation in place (equivalent to pressing Ctrl+S).

Args: presentation: Presentation name or path (None = active presentation).

Returns: JSON confirmation.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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.

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.