Skip to main content
Glama
Cross-Platform PowerPoint MCP Server

Cross-Platform PowerPoint MCP Server

🎯 Cross-Platform PowerPoint MCP Server

Python 3.10+ License: MIT PyPI version Cross-Platform

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

Related MCP server: PPTX MCP Server

πŸš€ 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.

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature/amazing-feature

  3. Make your changes and add tests

  4. Commit: git commit -m 'Add amazing feature'

  5. Push: git push origin feature/amazing-feature

  6. Open a Pull Request

πŸ“„ License

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

πŸ™ Acknowledgments

πŸ“ž Support


Made with ❀️ for the Claude Desktop community

Available Tools

13 tools
add_slideA
Add a new slide to the presentation.

Args:
    presentation_id: ID of the presentation
    layout_type: Slide layout type (default is 1, title slide)
        1: ppLayoutTitle (title slide)
        2: ppLayoutText (slide with title and text)
        3: ppLayoutTwoColumns (two-column slide)
        7: ppLayoutBlank (blank slide)
        etc...

Returns:
    Information about the new slide

Inputs: presentation_id (required), layout_type. Returns: result

add_text_boxA
Add a text box to a slide and set its text content.

Args:
    presentation_id: ID of the presentation
    slide_id: ID of the slide (numeric string)
    text: Text content
    left: Left edge position of the text box (points)
    top: Top edge position of the text box (points)
    width: Width of the text box (points)
    height: Height of the text box (points)

Returns:
    Operation status and ID of the new shape

Inputs: presentation_id (required), slide_id (required), text (required), left, +3 more. Returns: result

close_presentationC
Close a presentation.

Args:
    presentation_id: ID of the presentation
    save: Whether to save changes before closing

Returns:
    Status of the operation

Inputs: presentation_id (required), save. Returns: result

create_presentationB
Create a new PowerPoint presentation.

Returns:
    Dictionary containing new presentation ID and metadata

Inputs: no named parameters. Returns: result

get_platform_infoB
Get information about the current platform and available PowerPoint adapters.

Returns:
    Platform and adapter information

Inputs: no named parameters. Returns: result

get_presentationsB

Get a list of all open PowerPoint presentations with their metadata.

Inputs: no named parameters. Returns: result

get_slidesC
Get a list of all slides in a presentation.

Args:
    presentation_id: ID of the presentation

Returns:
    List of slide metadata

Inputs: presentation_id (required). Returns: result

get_slide_textB
Get all text content in a slide.

Args:
    presentation_id: ID of the presentation
    slide_id: ID of the slide (integer)

Returns:
    Dictionary containing text content organized by shape

Inputs: presentation_id (required), slide_id (required). Returns: result

initialize_powerpointB
Initialize connection to PowerPoint.

Returns:
    Status of initialization and platform information

Inputs: no named parameters. Returns: result

open_presentationB
Open a PowerPoint presentation from the specified path.

Args:
    path: Full path to the PowerPoint file (.pptx, .ppt)

Returns:
    Dictionary with presentation ID and metadata

Inputs: path (required). Returns: result

save_presentationB
Save a presentation to disk.

Args:
    presentation_id: ID of the presentation
    path: Optional path to save the file (if None, save to current location)

Returns:
    Status of the operation

Inputs: presentation_id (required), path. Returns: result

set_slide_titleB
Set the title text of a slide.

Args:
    presentation_id: ID of the presentation
    slide_id: ID of the slide (numeric string)
    title: New title text

Returns:
    Status of the operation

Inputs: presentation_id (required), slide_id (required), title (required). Returns: result

update_textC
Update the text content of a shape.

Args:
    presentation_id: ID of the presentation
    slide_id: ID of the slide (numeric string)
    shape_id: ID of the shape (numeric string)
    text: New text content

Returns:
    Status of the operation

Inputs: presentation_id (required), slide_id (required), shape_id (required), text (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between add_text_box and update_text that could cause confusion. add_text_box creates a new text box with content, while update_text modifies existing text in a shape, but both involve text manipulation on slides. Other tools like create_presentation, open_presentation, and close_presentation are clearly differentiated.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, such as add_slide, get_slides, and save_presentation. The naming is predictable and uniform throughout the set, making it easy for agents to understand the action and target.

    Tool Count5/5

    With 13 tools, the server is well-scoped for PowerPoint operations, covering presentation lifecycle, slide management, and text editing. Each tool serves a clear purpose without redundancy, and the count is appropriate for the domain, allowing comprehensive control without being overwhelming.

    Completeness4/5

    The tool set provides strong coverage for core PowerPoint tasks, including CRUD operations for presentations and slides, and text manipulation. However, there are minor gaps, such as missing tools for adding images, shapes, or charts, and no direct way to delete slides or shapes, which agents might need to work around.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers