1
Add it to Claude Code
claude mcp add powerpoint-mcp -- python -m powerpoint_mcp_server2
Make your agent remember this setup
powerpoint-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Cross-platform compatibility for Windows, macOS, and Linux
- Complete PowerPoint automation including creation, editing, and saving
- Intelligent adapter selection using COM API on Windows or python-pptx
- Rich text manipulation including adding text boxes and updating content
- Support for advanced techniques like morph transitions and animations
Tools 12
initialize_powerpointInitialize PowerPoint connectionget_platform_infoGet system and adapter informationcreate_presentationCreate new presentationopen_presentationOpen existing presentationsave_presentationSave presentationclose_presentationClose presentationget_slidesList all slidesadd_slideAdd new slideget_slide_textExtract slide textset_slide_titleSet slide titleadd_text_boxAdd text boxupdate_textUpdate text contentTry it
→What platform am I running on and what PowerPoint adapter is available?
→Please create a new PowerPoint presentation with a title slide called 'AI-Powered Presentations'
→Add a content slide explaining the benefits of cross-platform automation
→Save the presentation to ~/Documents/my-ai-presentation.pptx
Original README from vancealexander/Powerpoint_MCP_CrossPlatform
🎯 Cross-Platform PowerPoint MCP Server
A cross-platform PowerPoint automation server that works with Claude Desktop via the Model Context Protocol (MCP). Create, edit, and manage PowerPoint presentations on Windows, macOS, and Linux using AI assistance.
✨ Features
- 🌍 Cross-platform compatibility (Windows, macOS, Linux)
- 🎨 Complete PowerPoint automation - Create, edit, save presentations
- 🔄 Intelligent adapter selection - COM API on Windows, python-pptx everywhere else
- 🤖 Claude Desktop integration - Control PowerPoint through natural language
- 📝 Rich text manipulation - Add text boxes, update content, set titles
- 🎭 Advanced techniques support - Perfect for morph transitions and animations
- 📦 Easy installation - Available on PyPI
🚀 Quick Start
Installation
pip install powerpoint-mcp-server
Platform-specific notes:
- Windows: Optionally install
pywin32for direct PowerPoint COM API access - macOS/Linux: Uses
python-pptxlibrary (installed automatically)
Claude Desktop Configuration
Add to your Claude Desktop configuration file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
{
"mcpServers": {
"powerpoint": {
"command": "python",
"args": ["-m", "powerpoint_mcp_server"]
}
}
}
💬 Usage Examples
Once configured, interact with PowerPoint through Claude Desktop:
🤖 What platform am I running on and what PowerPoint adapter is available?
🤖 Please create a new PowerPoint presentation with a title slide called "AI-Powered Presentations"
🤖 Add a content slide explaining the benefits of cross-platform automation
🤖 Save the presentation to ~/Documents/my-ai-presentation.pptx
🔧 Available Functions
Core Operations
initialize_powerpoint()- Initialize PowerPoint connectionget_platform_info()- Get system and adapter informationcreate_presentation()- Create new presentationopen_presentation(path)- Open existing presentationsave_presentation(id, path)- Save presentationclose_presentation(id)- Close presentation
Slide Management
get_slides(presentation_id)- List all slidesadd_slide(presentation_id, layout_type)- Add new slideget_slide_text(presentation_id, slide_id)- Extract slide textset_slide_title(presentation_id, slide_id, title)- Set slide title
Content Editing
add_text_box(presentation_id, slide_id, text, ...)- Add text boxupdate_text(presentation_id, slide_id, shape_id, text)- Update text content
🖥️ Platform Support
| Feature | Windows + PowerPoint | Windows (python-pptx) | macOS | Linux |
|---|---|---|---|---|
| Create presentations | ✅ | ✅ | ✅ | ✅ |
| Edit presentations | ✅ | ✅ | ✅ | ✅ |
| Live PowerPoint control | ✅ | ❌ | ❌ | ❌ |
| File-based operations | ✅ | ✅ | ✅ | ✅ |
| Morph transitions* | ✅ | ✅ | ✅ | ✅ |
*Morph transitions require PowerPoint Desktop for playback
🎭 Advanced Use Cases
This MCP server is perfect for:
- AI-assisted presentation creation
- Batch processing PowerPoint files
- Cross-platform presentation workflows
- Advanced animation techniques (liquid masks, morph effects)
- Automated content generation
- Educational presentation tools
🏗️ Architecture
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Claude Desktop │◄──►│ MCP Protocol │◄──►│ This Server │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ Platform Detect │
└─────────────────┘
│
┌────────────────────┼────────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Windows COM API │ │ python-pptx │ │ Fallback Handler│