Cross-Platform PowerPoint MCP Server

🎯 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

*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│