🎯 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 pywin32 for direct PowerPoint COM API access
macOS/Linux: Uses python-pptx library (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 connection
get_platform_info() - Get system and adapter information
create_presentation() - Create new presentation
open_presentation(path) - Open existing presentation
save_presentation(id, path) - Save presentation
close_presentation(id) - Close presentation

Slide Management

get_slides(presentation_id) - List all slides
add_slide(presentation_id, layout_type) - Add new slide
get_slide_text(presentation_id, slide_id) - Extract slide text
set_slide_title(presentation_id, slide_id, title) - Set slide title

Content Editing

add_text_box(presentation_id, slide_id, text, ...) - Add text box
update_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│
                          │   (pywin32)     │  │ (Cross-platform)│  │   (No adapter)  │
                          └─────────────────┘  └─────────────────┘  └─────────────────┘

🛠️ Development

Setup Development Environment

# Clone repository
git clone https://github.com/your-username/powerpoint-mcp-server.git
cd powerpoint-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e ".[dev]"

Running Tests

pytest

Building Package

python -m build

📝 Requirements

Python 3.10+
Claude Desktop client
Optional: PowerPoint Desktop (for live control on Windows)

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide.

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and add tests
Commit: git commit -m 'Add amazing feature'
Push: git push origin feature/amazing-feature
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Model Context Protocol (MCP) - Communication protocol
python-pptx - Cross-platform PowerPoint library
pywin32 - Windows COM API access
Claude Desktop - AI-powered automation platform

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: Project Wiki

Made with ❤️ for the Claude Desktop community