PptMcp - MCP Server for Microsoft PowerPoint

The install badges register the server as ppt-mcp running the mcp-ppt command. Install the tool first with dotnet tool install --global PptMcp.McpServer, otherwise the client has nothing to launch.

Automate PowerPoint with AI — A Model Context Protocol (MCP) server for comprehensive PowerPoint automation through conversational AI.

PptMcp enables AI assistants such as GitHub Copilot, Claude, and ChatGPT to automate Microsoft PowerPoint through natural language commands. It covers real presentation work end to end: create slides, edit text, place shapes and images, build charts and tables, apply themes, run VBA, export to PDF or video, and manage live PowerPoint windows safely through the native COM API.

Origin and credit: This project builds on the original MCP automation foundation created by Stefan Broenner (sbroenne) in mcp-server-excel, extended here into a full PowerPoint-focused toolchain.

Releases and packages: GitHub Releases | NuGet: PptMcp.McpServer | NuGet: PptMcp.CLI

For multi-phase build / verify / repair workflows from source, the repo also includes the official orchestration client under src\PptMcp.Agent.

🛡️ 100% Safe — Uses PowerPoint's Native COM API — Zero risk of file corruption. Uses PowerPoint's official COM API ensuring complete safety and compatibility.

💡 Interactive Development — See results instantly in PowerPoint. Add slides, create charts, format text, and iterate. PowerPoint becomes your AI-powered workspace.

Technical Requirements:

• ⚠️ Windows Only — COM interop is Windows-specific
• ⚠️ PowerPoint Required — Microsoft PowerPoint 2016 or later must be installed
• ⚠️ Desktop Environment — Controls actual PowerPoint process (not for server-side processing)

🎯 What You Can Do

33 specialized tools with 224 operations:

• 📁 Files (1 tool, 6 ops) — Open, close, create, save, list, validate presentations
• 📄 Slides (1 tool, 15 ops) — Create, duplicate, move, delete, apply layouts, hide/unhide, thumbnails, clone-with-replace
• 🔷 Shapes (1 tool, 35 ops) — Add, move, resize, fill, gradient, line, shadow, glow, reflection, opacity, 3D, rotation, z-order, grouping, connectors, merge, flip, scale
• ✏️ Text (1 tool, 18 ops) — Get/set text, find, replace, format, spacing, bullets, case, symbols, alt-text audit
• 📋 Slide Tables (1 tool, 13 ops) — Create, read/write cells and rows, add/delete rows and columns, merge, format, borders
• 📊 Charts (1 tool, 10 ops) — Create, set data, title, type, legend, axis titles, data table
• 🖼️ Images (1 tool, 4 ops) — Insert, crop, brightness/contrast, transparent color
• 🎥 Media (1 tool, 4 ops) — Insert audio/video, media info, playback settings
• 🧩 SmartArt (1 tool, 6 ops) — Diagram info, add/delete nodes, layout, style, level changes
• 🎨 Design/Themes (1 tool, 19 ops) — Themes, color schemes, fonts, archetypes, palettes, layout grids, style profiles
• 🖌️ Slide Background (1 tool, 5 ops) — Get, solid color, gradient, image, reset to master
• 🎭 Masters & Layouts (1 tool, 5 ops) — List masters and layouts, edit master shapes, delete unused
• 📌 Placeholders (1 tool, 3 ops) — List placeholders, set text, set image
• 📃 Headers & Footers (1 tool, 2 ops) — Get/set footer text, slide numbers, date
• 📐 Page Setup (1 tool, 3 ops) — Slide size, orientation, first slide number
• ↔️ Shape Alignment (1 tool, 2 ops) — Align and distribute shapes on slides
• 🎬 Animations (1 tool, 6 ops) — List, add, remove, clear, timing, reorder
• 🔀 Transitions (1 tool, 4 ops) — Get, set, remove, copy to all slides
• 📺 Slideshow (1 tool, 5 ops) — Start, stop, navigate, status, configure
• 🎞️ Custom Shows (1 tool, 3 ops) — Create, list, delete custom slide shows
• 📂 Sections (1 tool, 4 ops) — List, add, rename, delete presentation sections
• 📥 Slide Import (1 tool, 1 op) — Import slides from another .pptx file
• 📝 Notes (1 tool, 5 ops) — Get, set, clear, append, read all speaker notes
• 💬 Comments (1 tool, 4 ops) — Add, list, delete, clear slide comments
• 🔗 Hyperlinks (1 tool, 5 ops) — Add, get, list, remove, validate hyperlinks
• 🏷️ Tags (1 tool, 3 ops) — Custom metadata on slides and shapes
• 🗂️ Document Properties (1 tool, 4 ops) — Get/set built-in and custom properties
• ♿ Accessibility (1 tool, 3 ops) — Audit, get/set reading order
• 🔤 Proofing (1 tool, 3 ops) — Spell check, get/set language
• 📤 Export (1 tool, 9 ops) — PDF, slide images, video (MP4), print, save-as, extract text/images
• 🖨️ Print Options (1 tool, 2 ops) — Get/set print configuration
• ⚙️ VBA (1 tool, 5 ops) — List, view, import, delete, run macros
• 🪟 Window (1 tool, 7 ops) — Info, minimize, restore, maximize, zoom, view mode

📚 Complete Feature Reference → — Detailed documentation of all 224 operations

💬 Example Prompts

Create & Build Presentations:

• "Create a new PowerPoint presentation called QuarterlyReport.pptx with a title slide"
• "Add 5 slides with a 'Title and Content' layout"
• "Insert a company logo image on the first slide"

Content & Formatting:

• "Add a textbox on slide 2 with the text 'Q1 Revenue Summary' in bold 24pt Arial"
• "Create a table on slide 3 with columns for Region, Q1, Q2, Q3, Q4"
• "Set the shape fill color to #0078D4 and add a 2pt border"

Charts & Visuals:

• "Create a bar chart on slide 4 showing quarterly revenue data"
• "Set the chart title to 'Revenue by Quarter'"
• "Add an entrance animation to the chart shape"

Automation:

• "Export the presentation as PDF"
• "Run the FormatAllSlides macro"
• "Show me PowerPoint while you work" — watch changes in real-time

🪟 Agent Mode — Watch AI Work in PowerPoint:

• "Show me PowerPoint side-by-side while you build this presentation" — real-time visibility
• "Let me watch while you create the slides"
• Status bar shows live progress: "PptMcp: Creating chart on slide 4..."

👥 Who Should Use This?

Perfect for:

• ✅ Presenters automating repetitive PowerPoint workflows
• ✅ Developers building PowerPoint-based reporting solutions
• ✅ Business users managing complex presentation decks
• ✅ Teams maintaining presentation templates and VBA macros

Not suitable for:

• ❌ Server-side processing (use libraries like Open XML SDK instead)
• ❌ Linux/macOS users (Windows + PowerPoint installation required)
• ❌ High-volume batch operations (consider PowerPoint-free alternatives)

🚀 Quick Start

⚠️ Important: Close all PowerPoint files before using. The server requires exclusive access to presentations during automation.

🔧 CLI vs MCP Server

This package provides both CLI and MCP Server interfaces. Choose based on your use case:

Manual Installation:

# Install MCP Server and CLI
dotnet tool install --global PptMcp.McpServer
dotnet tool install --global PptMcp.CLI

Without .NET installed: the MCP server is also published to npm as a wrapper that downloads a self-contained build on first use. Point any client at npx -y mcp-server-ppt instead of mcp-ppt. Windows x64 only.