macpoint 0.1.0

macOS MCP server for Microsoft PowerPoint for Mac — automate slide decks from Cursor and other MCP clients.

MacPoint

macOS MCP server for Microsoft PowerPoint for Mac — automate slide decks from Cursor, Claude, and other MCP clients.

MacPoint gives AI agents the ability to create, edit, and manage PowerPoint presentations on your Mac using the Model Context Protocol. Tool names and parameters are aligned with powerpoint-mcp (Windows/COM) for cross-platform agent compatibility.

What it does

• 11 MCP tools for PowerPoint automation (open, save, create from template, add slides, populate text, navigate, and more)
• AppleScript backend drives the live PowerPoint app (open, save, close, navigate slides)
• python-pptx backend handles on-disk edits (populate placeholders, add slides) without needing the app open

Install

pip install macpoint

Or with uv:

uv add macpoint

Configure Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "macpoint": {
      "command": "macpoint",
      "args": []
    }
  }
}

Restart Cursor after editing. On first use, macOS will ask you to grant Automation permission (Cursor → Microsoft PowerPoint) in System Settings → Privacy & Security → Automation.

Tools

Tool	Status	What it does
manage_presentation	Working	Open, create (blank or from template), save, save_as, close
populate_placeholder	Working	Set plain text on named placeholders (python-pptx)
add_slide_with_layout	Working	Append a slide using a named layout
switch_slide	Working	Navigate to a slide by number (AppleScript)
evaluate	Safe	Returns guidance (does NOT execute arbitrary code)
slide_snapshot	Stub	Not yet implemented
add_speaker_notes	Stub	Not yet implemented
list_templates	Stub	Not yet implemented
analyze_template	Stub	Not yet implemented
manage_slide	Stub	Not yet implemented
add_animation	Stub	Not yet implemented

Example: Create a deck from a template

manage_presentation(action="create", template_path="/path/to/template.potx", file_path="/path/to/new-deck.pptx")
add_slide_with_layout(template_name="", layout_name="Title and Content", after_slide=0)
populate_placeholder(placeholder_name="Title", content="Hello World", slide_number=1)
manage_presentation(action="save")

Requirements

• macOS (AppleScript is Mac-only)
• Microsoft PowerPoint for Mac (installed and launchable)
• Python 3.10+

Development

git clone https://github.com/AndrewIgdal17/macpoint.git
cd macpoint
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/macpoint

Support

If MacPoint saves you time, consider sponsoring the project.

Attribution

• API reference: Ayushmaniar/powerpoint-mcp (MIT). MacPoint is independent code for macOS.
• Microsoft PowerPoint is a trademark of Microsoft Corporation.

License

MIT