pptx-mcp — Local PowerPoint MCP Server for Claude

A fully-auditable, locally-hosted MCP server that lets Claude create, edit, and export Microsoft PowerPoint presentations on your Windows machine — with full support for SAP corporate templates.

Built by Brijesh Shetty. Zero telemetry. No external network calls. All 24 tools visible in a single Python file.

What It Does

Related MCP server: Slideforge

Prerequisites

Quick Start

1. Clone the repo

git clone https://github.com/brijeshshetty/pptx-mcp.git
cd pptx-mcp

2. Install dependencies

pip install -r requirements.txt

All four dependencies are pinned for reproducibility:

mcp==1.27.0
python-pptx==1.0.2
Pillow==12.3.0
pywin32==311

3. Verify the install

python -c "from pptx_mcp_server import mcp; print('Tools:', len(mcp._tool_manager._tools))"
# Expected: Tools: 24

4. Connect to Claude Desktop

Open (or create) your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the powerpoint entry:

{
  "mcpServers": {
    "powerpoint": {
      "command": "C:\\Path\\To\\Python\\python.exe",
      "args": [
        "C:\\Path\\To\\pptx-mcp\\pptx_mcp_server.py"
      ]
    }
  }
}

Replace both paths with your actual Python executable and clone location.

5. Restart Claude Desktop

Quit completely and reopen. You should see PowerPoint MCP in the tools panel (hammer icon).

SAP Corporate Template Support

If you have an SAP .pptx file with the official slide master (e.g. a DRC setup guidance deck), place its path in the _SAP_TEMPLATE constant at the top of pptx_mcp_server.py:

# Line ~860 in pptx_mcp_server.py
_SAP_TEMPLATE = r"C:\Path\To\Your\SAP_Template.pptx"

This unlocks four extra tools that inherit all 40 SAP layouts including:

• Cover A — dark blue right panel with chevron graphic

• Divider Page C — white top / blue-chevron bottom

• Title and Text: 2 Columns — standard content

• Q & A, Thank You A, Agenda A/B, and more

Example prompt to Claude after connecting:

"Create an SAP-branded presentation at C:/Users/me/Documents/France_DRC.pptx. Add a cover slide titled 'France B2B E-Invoicing — Setup Guidance'. Add a divider slide 'Introduction and Latest Status'. Add a two-column content slide with the e-invoicing scope on the left and e-reporting scope on the right. Save it."

Example Prompts

Basic deck

"Create a new presentation at C:/Users/me/Documents/MyDeck.pptx. Add a slide with a dark blue background. Add a white title 'Hello World'. Add a table with 3 columns and 4 rows of sample data. Save it."

Export to PDF

"Open C:/Users/me/Documents/MyDeck.pptx as 'deck'. Export it as a PDF to C:/Users/me/Documents/MyDeck.pdf."

Export slides as images

"Open MyDeck.pptx as 'deck'. Export all slides as 1920x1080 PNG images to C:/Users/me/Desktop/slides/."

Security Model

This server is designed to be fully auditable:

• No external network calls — verified by source inspection (no requests, urllib, socket, subprocess, eval, or exec in the server code)

• Path traversal protection — all file paths are validated against an allowlist (home directory + temp dir)

• Pinned dependencies — four packages, all pinned to specific versions

• Single file — the entire server is pptx_mcp_server.py (~900 lines)

The COM tools (launch_powerpoint, export_pdf, export_slide_images) require Microsoft PowerPoint to be installed and run within your user session — they do not spawn processes with elevated privileges.

Project Structure

pptx-mcp/
  pptx_mcp_server.py          # The complete MCP server (24 tools)
  requirements.txt            # 4 pinned dependencies
  claude_desktop_config_snippet.json   # Paste into Claude Desktop config
  build_test_deck.py          # Demo: builds a 5-slide test deck
  build_sap_branded.py        # Demo: builds a 10-slide SAP-branded deck
  gen_sap_pattern.py          # Utility: generates SAP chevron background PNGs
  SETUP.md                    # Detailed setup notes

Running the Demos

# Build a plain 5-slide test deck (no template required)
python build_test_deck.py

# Build a 10-slide SAP-branded deck (requires _SAP_TEMPLATE to be set)
python build_sap_branded.py

Shapes Supported by add_shape

rectangle, rounded_rectangle, oval, diamond, right_arrow, chevron, pentagon, hexagon, parallelogram, triangle

Troubleshooting

Changelog

License

MIT — see LICENSE.

Contributing

Issues and PRs welcome. If you add support for a new corporate template (KSA, India, etc.), follow the same pattern as the SAP tools: extract the slide master from the reference .pptx and expose layout-aware add_*_slide helpers.