What is Powerpoint Automation Mcp

powerpoint-automation-mcp is an MCP server designed to provide automation capabilities for PowerPoint presentations, allowing users to create, modify, and manage presentations programmatically.

Use cases

Use cases include automating the creation of presentation slides for business meetings, generating educational content for classrooms, and dynamically updating presentations based on data inputs.

How to use

To use powerpoint-automation-mcp, run the server using the command ‘uv run --directory /path/to/mcp-ppt-server mcp-ppt-server’. The server allows various automation tasks through its API, including presentation and slide management.

Key features

Key features include creating, opening, and saving PowerPoint presentations, adding and modifying slides, inserting text boxes, images, tables, and charts, updating text content, and retrieving table content.

Where to use

powerpoint-automation-mcp can be used in various fields such as education for creating teaching materials, corporate environments for generating reports and presentations, and any scenario requiring automated PowerPoint generation.

MCP Server Demo - PowerPoint Automation

This project demonstrates how to use MCP (Model Completion Protocol) to create a server that provides PowerPoint automation capabilities for Amazon Q.

Demo

https://github.com/user-attachments/assets/3daf3bef-4d75-4639-a891-0e64b80b4807

Features

• Create, open, and save PowerPoint presentations
• Add and modify slides
• Add text boxes, images, tables, and charts
• Update text content and shape properties
• Retrieve table content

Running the Server

To run the server:

uv run --directory  /path/to/mcp-ppt-server mcp-ppt-server 

Usage

The server exposes various tools for PowerPoint automation that can be called via MCP. The server is designed to work with a single active presentation at a time, which simplifies the API by eliminating the need to track and specify presentation IDs.

Presentation Management

• initialize_powerpoint(): Initialize PowerPoint automation
• create_presentation(template=None): Create a new presentation, optionally using a template file
• open_presentation(file_path): Open an existing presentation from the specified path
• get_presentation(): Get information about the currently active presentation
• save_presentation(path=None): Save the active presentation to disk (path is optional if presentation was previously saved)
• close_presentation(): Close the active presentation

Slide Management

• get_slides(): Get a list of all slides in the active presentation
• add_slide(layout_index=1): Add a new slide with specified layout (default is Title and Content)
  • Layout options: 0=Title slide, 1=Title and content, 2=Section header, 3=Two content, etc.
• set_slide_title(slide_index, title): Set the title text of a slide

Content Management

• get_slide_text(slide_index): Get all text content in a slide
• get_slide_shapes(slide_index): Get all shapes in a slide with their IDs and properties
• update_text(slide_index, shape_index, text): Update the text content of a shape
• update_shape_by_id(slide_index, shape_id, text=None, left=None, top=None, width=None, height=None): Update a shape by its ID with new properties
• update_table_cell(slide_index, shape_index, row, col, text): Update the text in a table cell

Adding Content

• add_textbox(slide_index, text, left=1, top=1, width=4, height=2): Add a text box to a slide
• add_image(slide_index, image_path, left=1, top=1, width=None, height=None): Add an image to a slide
• add_table(slide_index, rows, cols, left=1, top=1, width=8, height=4): Add a table to a slide
• get_table_content(slide_index, shape_index): Retrieve the content of a table in a slide
• add_chart(slide_index, chart_type, categories, series_names, series_values, left=1, top=1, width=8, height=4, has_legend=True): Add a chart to a slide with multiple data series
  • Chart types: ‘COLUMN’, ‘LINE’, ‘PIE’, ‘BAR’
  • categories: List of category names (x-axis labels)
  • series_names: List of series names for the legend
  • series_values: List of lists containing values for each series

Error Handling

Most functions return a dictionary with either success information or error details. Always check for the presence of an “error” key in the returned dictionary to handle errors appropriately.

Example error response:

{
  "error": "No active presentation. Please open or create a presentation first."
}

MCP Config

{
  "mcpServers": {
    "ppt-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/mcp-ppt-server",
        "mcp-ppt-server"
      ]
    }
  }
}