PPT MCP Server

🚀 PowerPoint Automation MCP Server for Claude Desktop

This project offers a PowerPoint automation server that works with Claude Desktop through the Model Control Protocol (MCP). It enables Claude to interact with Microsoft PowerPoint, facilitating tasks such as creating presentations, adding slides, and modifying content.

🚀 Quick Start

This server allows you to use Claude Desktop to control PowerPoint. After configuration, you can interact with PowerPoint through Claude Desktop.

✨ Features

• Create, open, save, and close PowerPoint presentations.
• List all open presentations.
• Get slide information and content.
• Add new slides with different layouts.
• Add text boxes to slides.
• Update text content in shapes.
• Set slide titles.
• And many more features!

📦 Installation

1. Clone this repository.
2. Install dependencies:

   uv add fastmcp pywin32
   

3. Configure Claude Desktop:
   • Open Claude Desktop.
   • Navigate to settings.
   • Configure the MCP server as instructed.

📚 Documentation

Configuration

To configure Claude Desktop to use this MCP server, add the following content to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "ppts": {
      "command": "uv",
      "args": ["run", "path/to/main.py"]
    }
  }
}

If you are using a virtual environment or other Python executables (e.g., uv):

{
  "mcpServers": {
    "ppts": {
      "command": "C:\\Path\\To\\Python\\Scripts\\uv.exe",
      "args": ["run", "C:\\Path\\To\\Project\\main.py"]
    }
  }
}

Usage Examples

After configuration, you can use Claude Desktop to control PowerPoint. Example interactions:

Basic Usage

Can you open PowerPoint for me?

Advanced Usage

Please create a new PowerPoint presentation.

Add a new slide to the presentation.

Add a text box containing the text "Hello World" to slide 1.

Save the presentation to C:\Users\username\Documents\presentation.pptx

🔧 Technical Details

The server provides the following PowerPoint automation functions:

• initialize_powerpoint(): Connect to PowerPoint and make it visible.
• get_presentations(): List all open presentations.
• open_presentation(path): Open a presentation from a file.
• get_slides(presentation_id): Get all slides in a presentation.
• get_slide_text(presentation_id, slide_id): Get the text content of a slide.
• update_text(presentation_id, slide_id, shape_id, text): Update text in a shape.
• save_presentation(presentation_id, path): Save a presentation.
• close_presentation(presentation_id, save): Close a presentation.
• create_presentation(): Create a new presentation.
• add_slide(presentation_id, layout_type): Add a new slide.
• add_text_box(presentation_id, slide_id, text, left, top, width, height): Add a text box.
• set_slide_title(presentation_id, slide_id, title): Set the title of a slide.

⚠️ Requirements

• A Windows system with Microsoft PowerPoint installed.
• Python 3.7+.
• Claude Desktop client.
• pywin32 and fastmcp Python packages.

⚠️ Limitations

• Can only run on Windows with PowerPoint installed.
• The PowerPoint application will open and be visible during operations.
• Limited to the functions exposed by the PowerPoint COM API.

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License