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 your MCP client
MacPoint works with any MCP client.
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"macpoint": {
"command": "macpoint",
"args": []
}
}
}
Restart Cursor after editing.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"macpoint": {
"command": "macpoint",
"args": []
}
}
}
Restart Claude Desktop after editing.
Other MCP clients
Point your client at the macpoint command (stdio transport, JSON-RPC). Any client that speaks the Model Context Protocol will work.
Python (no MCP client)
You can use the backends directly without an MCP client:
from macpoint.backends.template_instantiate import copy_template_to_new_presentation
from macpoint.backends.pptx_backend import add_slide, populate_plain_text
from pathlib import Path
copy_template_to_new_presentation(Path("template.potx"), Path("deck.pptx"))
add_slide(Path("deck.pptx"), "Title and Content")
populate_plain_text(Path("deck.pptx"), 1, "Title", "Hello World")
On first use, macOS will ask you to grant Automation permission (your app → 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) |
slide_snapshot |
Working | Text snapshot of shapes, placeholders, text, and speaker notes |
add_speaker_notes |
Working | Set speaker notes on any slide (overwrites) |
list_templates |
Working | Scan macOS template directories |
analyze_template |
Working | Enumerate layouts, placeholders, types, and dimensions |
manage_slide |
Working | Delete, move (reorder), or duplicate slides |
evaluate |
Safe | Returns guidance (does NOT execute arbitrary code) |
add_animation |
N/A | Not feasible on Mac (animation schema unsupported) |
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
Metadata
Release files for macpoint 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| macpoint-0.2.0.tar.gz | 26.8 kB | With provenance | Details for macpoint-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| macpoint-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for macpoint-0.2.0-py3-none-any.whl |
Total release size: 40.7 kB
Release files / macpoint-0.2.0.tar.gz
| Download URL | macpoint-0.2.0.tar.gz |
|---|---|
| Size | 26.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2a6ea1b228ca3697c109986ec3d5ed29789ff182c5e1eaa7b394433427190e4f
|
|
BLAKE2b-256 checksum How to use checksums |
727fc06e14bbeda0616a9e4a7df33c5ba5b1e191aa9e858346c19dc7657c4d7d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 21, 2026.
Transparency logRelease files / macpoint-0.2.0-py3-none-any.whl
| Download URL | macpoint-0.2.0-py3-none-any.whl |
|---|---|
| Size | 13.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1e0d24d39cd3e7ce6f100badbaab54cc6ca1e1b14ea3d23675fca34a0f0cf05
|
|
BLAKE2b-256 checksum How to use checksums |
27f4a7f2e39f340b0559f8cd128d634402f62925abc2441a3427d945501b1cdf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 21, 2026.
Transparency logSecurity for macpoint 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for macpoint-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.