Powerpoint Automation

🚀 PowerPoint Automation MCP Server for Claude Desktop

This project offers a PowerPoint automation server designed to work with Claude Desktop, enabling interaction through the Model Control Protocol (MCP). It allows Claude to control Microsoft PowerPoint, performing tasks such as creating presentations, adding slides, and modifying content.

🚀 Quick Start

This project provides a PowerPoint automation server that interacts with Claude Desktop via the Model Control Protocol (MCP). It enables Claude to control Microsoft PowerPoint, performing tasks like creating presentations, adding slides, and modifying content.

✨ Features

• Create, open, save, and close PowerPoint presentations.
• List all open presentations.
• Retrieve slide information and content.
• Add new slides with different layouts.
• Insert text boxes into slides.
• Update the text content within shapes.
• Set slide titles.
• And many more!

📦 Installation

1. Clone this repository:
2. Install the dependencies:

   uv add fastmcp pywin32
   

3. Configure Claude Desktop:
   • Open Claude Desktop.
   • Navigate to the settings.
   • Configure the MCP server as per the following instructions.

📚 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 another Python executable (e.g., uv):

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

💻 Usage Examples

Basic Usage

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

1. Initialize PowerPoint:

   Can you open PowerPoint for me?
   

2. Create a new presentation:

   Please create a new PowerPoint presentation.
   

3. Add a slide:

   Add a new slide to the presentation.
   

4. Add content:

   Add a text box with the content "Hello, world" to the first slide.
   

5. Save the presentation:

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

Advanced Usage

The server provides the following PowerPoint automation functions:

• initialize_powerpoint(): Connect to and display PowerPoint.
• get_presentations(): List all open presentations.
• open_presentation(path): Open a presentation file.
• get_slides(presentation_id): Retrieve 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 the text within 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.

🔧 Technical Details

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

(Specific license information should be included here.)