---
slug: "ppt-mcp-server"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/socamalo/PPT_MCP_Server@main/README.md"
repo: "https://github.com/socamalo/PPT_MCP_Server"
source_file: "README.md"
branch: "main"
---
# 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!

## Quick Start
1. Use `uvx` to run:
```bash
uvx --from https://github.com/socamalo/PPT_MCP_Server.git mcp-ppt
```

## Installation

1. Clone this repository:

2. Install dependencies:

   ```bash
   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`:

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

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

```json
{
  "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](https://github.com/socamalo/PPT_MCP_Server/tree/HEAD/LICENSE)