socamalo_ppt_mcp_server

socamalo_ppt_mcp_server

by socamalo
A server enabling Claude Desktop to automate PowerPoint tasks via the Model Control Protocol (MCP).

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:
    shell git clone https://github.com/socamalo/PPT_MCP_Server.git
  2. Install dependencies:
    shell 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

Features & Capabilities

Categories
mcp_server model_context_protocol python powerpoint_automation claude api_integration windows

Implementation Details

View on GitHub

Stats

0 Views
5 GitHub Stars

Repository Info

socamalo Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI