PPT-MCP

Cross-platform Model Context Protocol server for Microsoft PowerPoint automation. Tool names and parameters align with powerpoint-mcp for cross-platform agent compatibility.

Platforms

Related MCP server: marp-agent-mcp

Requirements

• Python 3.10+

• Microsoft PowerPoint installed

• macOS: grant Automation permission for Cursor/terminal in System Settings → Privacy & Security → Automation

• Windows: pip install -e ".[windows]" and run pywin32_postinstall.py -install

Install

cd /Users/xintian/Desktop/PPT-MCP
python3 -m pip install -e .
# Windows only:
python3 -m pip install -e ".[windows]"

Cursor integration

Add to ~/.cursor/mcp.json or use the project config at .cursor/mcp.json:

{
  "mcpServers": {
    "ppt-mcp": {
      "command": "python3",
      "args": ["-m", "ppt_mcp"],
      "cwd": "/path/to/PPT-MCP"
    }
  }
}

Restart Cursor after configuration.

Tools (12)

Workspace (remap workflow)

Use the workspace/ folder for remap jobs:

workspace/input/old/          ← your old .pptx
workspace/input/templates/    ← your .potx / .pptx templates
workspace/output/             ← remapped results

See workspace/README.md for usage.

Development

python3 -m ppt_mcp          # run MCP server (stdio)
python3 -c "from ppt_mcp.backends.factory import get_backend; print(type(get_backend()).__name__)"

References

• Windows COM tools adapted from powerpoint-mcp (MIT)

• macOS backends adapted from macpoint (MIT)