What is Ppt Mcp Server

PPT_MCP_Server is a PowerPoint automation server designed to work with Claude Desktop via the Model Control Protocol (MCP). It enables users to automate various tasks in Microsoft PowerPoint, such as creating presentations, adding slides, and modifying content.

Use cases

Use cases for PPT_MCP_Server include automating the creation of presentation slides for meetings, generating reports with visual aids, and simplifying the process of modifying existing presentations through voice or text commands.

How to use

To use PPT_MCP_Server, first clone the repository and install the necessary dependencies. Then, configure Claude Desktop by adding the MCP server settings to the configuration file. Once configured, users can interact with PowerPoint through Claude Desktop by issuing commands.

Key features

Key features of PPT_MCP_Server include creating, opening, saving, and closing presentations; listing open presentations; retrieving slide information; adding new slides; updating text content; and setting slide titles.

Where to use

PPT_MCP_Server is primarily used in environments where Microsoft PowerPoint is utilized for creating presentations, such as educational institutions, corporate settings, and any scenario requiring automated presentation generation.

PowerPoint Automation MCP Server for Claude Desktop

This project provides a PowerPoint automation server that works with Claude Desktop via the Model Control Protocol (MCP). It allows Claude to interact with Microsoft PowerPoint, enabling tasks like creating presentations, adding slides, modifying content, and more.

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 more!

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 explained below

Configuration

To configure Claude Desktop to use this MCP server, add the following to your Claude Desktop configuration file, located at %APPDATA%\Claude\claude_desktop_config.json:

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

If you’re using a virtual environment or alternative Python executable (like uv):

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

Usage

Once configured, you can use Claude Desktop to control PowerPoint. Example interactions:

1. Initialize PowerPoint:

   Could 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 to slide 1 with the text "Hello World".
   

5. Save the presentation:

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

Available Functions

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

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

Limitations

• Works only on Windows with PowerPoint installed
• The PowerPoint application will open and be visible during operations
• Limited to the capabilities exposed by the PowerPoint COM API

Contributing

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

License

MIT License