Open Source Model Context Protocol server for PowerPoint automation on Windows via pywin32
Server has 11 tools with visible schemas and descriptions, but exhibits significant quality gaps across naming, parameter clarity, and error handling. Most tool names lack action verbs (only 3 of 11 start with clear verbs: 'manage', 'switch', 'add'). Description lengths are inconsistent, some thorough (manage_presentation: 458 chars), others minimal. Parameter descriptions exist but often lack constraints, valid enums, or format specifications. Output schemas are not documented in the visible code. Error handling is largely absent, no recovery guidance, no error classification, no actionable messages. The 'evaluate' tool is particularly problematic, offering arbitrary Python execution without clear boundaries or safety constraints. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) are present. Composition gaps: several tools could be consolidated (add_slide_with_layout + populate_placeholder form a common sequence but lack chaining context). This is a C-grade server with functional definitions but weak signal for LLM reasoning.
Add animation to a shape in PowerPoint. Adds animations to shapes with support for paragraph-level text animation.
Add a slide with a specific template layout at the specified position. Properly imports the template design to preserve all styling (backgrounds, fonts, colors, etc.).
Add speaker notes to a specific slide in the active PowerPoint presentation. Adds or replaces the speaker notes content for the specified slide with the provided text. Speaker notes are visible in presenter view and when printing notes pages, but not during the actual slideshow.
Analyze PowerPoint template layouts with comprehensive placeholder analysis and screenshots. Creates a hidden temporary presentation to analyze template layouts without interfering with the user's active presentation. Generates screenshots with green bounding boxes and yellow ID labels for all placeholders, and provides detailed placeholder analysis. Screenshots are saved to ~/.powerpoint-mcp/ directory (same as slide_snapshot tool) and can be viewed using the Read tool for visual reference.
Execute arbitrary Python code in PowerPoint automation context. Enables free-form PowerPoint automation beyond predefined tools, including: - Complex geometric calculations (circular flowcharts, grid layouts) - Advanced shape manipulations (rotations, custom positioning) - Data extraction using custom logic - Multi-shape operations with mathematical relationships - Access to all PowerPoint MCP tools via the 'skills' object
evaluate tool permits arbitrary Python execution without constraints, sandboxing, or permission gates. Violates security best practices and creates explosion risk for agent misuse.
No tool annotations present. Missing readOnlyHint on read-only tools (slide_snapshot, list_templates, analyze_template) and destructiveHint on write tools (manage_slide, manage_presentation, evaluate). Agents cannot distinguish safe from risky calls.
manage_slide tool has ambiguous operation parameter. Description mentions 'delete', 'copy', 'move' but does not specify whether these are required enum values or accepted as free-form strings. No constraint definition.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 53 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 36 | - | v1 |
Discover and list available PowerPoint templates. Scans common template directories (Personal, User, System) to find available PowerPoint template files (.potx, .potm, .pot). Returns a clean list of template names that can be used with the analyze_template tool. The tool searches in: - Personal Templates: Custom Office Templates folder - User Templates: AppData/Roaming/Microsoft/Templates - System Templates: Program Files/Microsoft Office/Templates
Comprehensive PowerPoint presentation management tool. This tool works on Windows only. Use Windows path format with double backslashes. Args: action: Action to perform - "open", "close", "create", "save", or "save_as" file_path: Path for open/create operations (required for open/create) save_path: New path for save_as operation (required for save_as) template_path: Template file for create operation (optional) presentation_name: Specific presentation name for close operation (optional) Actions: - "open": Opens an existing presentation (requires file_path) Example: action="open", file_path="C:\\Users\\Name\\slides.pptx" - "close": Closes a presentation (optional presentation_name, closes active if not specified) Example: action="close" or action="close", presentation_name="MyPresentation.pptx" - "create": Creates new presentation (optional file_path for immediate save, optional template_path) Example: action="create", file_path="C:\\new\\presentation.pptx" Example: action="create", template_path="C:\\templates\\corporate.potx", file_path="C:\\new\\slides.pptx" - "save": Saves current presentation at its current location Example: action="save" - "save_as": Saves current presentation to new location (requires save_path) Example: action="save_as", save_path="C:\\backup\\slides_v2.pptx" Use double backslashes (\\\\) in Windows paths.
Manage slides in the active PowerPoint presentation. Performs operations on slides including deletion, copying, and moving.
Populate slide placeholders with content. Populates a named placeholder with the provided content. The placeholder is located by exact name match (case-insensitive) from slide_snapshot results.
Capture comprehensive context of a PowerPoint slide with optional screenshot. This tool provides detailed information about the current (or specified) slide including all objects, text content with HTML formatting, tables, charts, and layout details. Includes optional screenshot functionality with green bounding boxes and yellow ID labels overlaid on all objects. The screenshot is saved to a file and the LLM is informed of the location for visual reference. The tool automatically detects the current active slide if no slide number is specified. It returns formatted slide context including object positions, IDs, text content with HTML formatting, and structural information.
Switch to a specific slide in the active PowerPoint presentation. Changes the current active slide to the specified slide number, allowing you to navigate through the presentation programmatically.
Output schemas are not documented for any tool. No tool specifies what fields it returns, their types, or structure. LLMs cannot plan downstream calls or extract data reliably.
Error handling is largely absent. No tool specifies what errors can occur, how to recover, or what the LLM should do next. Error messages in code return raw strings with no classification or guidance.
manage_presentation and manage_slide perform multiple distinct operations (create+open, copy+delete+move) under single tools with action enums. These should be split into atomic tools (create_presentation, open_presentation, copy_slide, delete_slide, move_slide) for better composability.
add_slide_with_layout returns no context about which slide was created, where it was inserted, or what layout properties were applied. Response must include slide_number and layout details for chaining to populate_placeholder.
slide_snapshot tool returns unstructured text context including HTML and verbose object listings. Should return structured JSON with object array, text content as markdown, and optional screenshot file path. This enables downstream tool calls without LLM parsing.
Parameter descriptions lack format constraints. Examples: 'file_path' in manage_presentation says 'Windows path format with double backslashes' but no regex/pattern constraint. 'effect' in add_animation lists examples but no enum. 'operation' in manage_slide is not enum-constrained.
No idempotency guarantees documented. Tools like manage_presentation (save, save_as), add_slide_with_layout, populate_placeholder lack idempotency statements. Agents will retry on ambiguous failures, risking duplicate slides, overwrites, or duplicated content.