MCP HubMCP Hub
supercurses

powerpoint

by: supercurses

A MCP Server for creating Powerpoint Presentations

75created 04/03/2025
Visit
PowerPoint
Automation

📌Overview

Purpose: The MCP server aims to automate the creation of PowerPoint presentations by providing a suite of tools that generate slides with various content formats.

Overview: This framework simplifies the process of constructing presentations by allowing users to create and edit presentations programmatically. It supports multiple types of slides, ensuring a versatile and efficient presentation-building experience.

Key Features:

  • create-presentation: Initializes a new presentation, enabling users to start adding content right away.

  • add-slide-title-only: Adds a title slide, helping to define the main topic of the presentation effectively.

  • add-slide-section-header: Inserts section headers to structure the presentation systematically.

  • add-slide-title-content: Introduces slides with both titles and content, allowing for detailed explanations and information presentation.

  • add-slide-title-with-table: Incorporates tables based on provided data, enhancing data visualization within the presentation.

  • add-slide-title-with-chart: Generates slides with charts that dynamically represent data, adapting to the best visual format for interpretation.

  • add-slide-picture-with-caption: Facilitates the addition of images, enhancing visual engagement and contextual illustration.

  • open-presentation: Provides functionality to edit existing presentations while ensuring data safety through automatic backups.

  • save-presentation: Ensures all changes are stored appropriately, finalizing the presentation process.

  • generate-and-save-image: Allows for the creation of images through AI, providing custom visuals tailored for the presentation needs.


PowerPoint MCP Server

A project that creates PowerPoint presentations using a server.

Components

Tools

The server implements the following tools:

  • create-presentation: Starts a presentation.

    • Requires: "name" (string)
  • add-slide-title-only: Adds a title slide.

    • Requires: "presentation_name" (string), "title" (string)
  • add-slide-section-header: Adds a section header slide.

    • Requires: "presentation_name" (string), "header" (string)
  • add-slide-title-content: Adds a title with content slide.

    • Requires: "presentation_name" (string), "title" (string), "content" (string)
  • add-slide-title-with-table: Adds a title slide with a table.

    • Requires: "presentation_name" (string), "title" (string), "data" (array)
  • add-slide-title-with-chart: Adds a title slide with a chart.

    • Requires: "presentation_name" (string), "title" (string), "data" (object)
  • add-slide-picture-with-caption: Adds a picture with caption slide.

    • Requires: "presentation_name" (string), "title" (string), "caption" (string), "image_path" (string)
  • open-presentation: Opens a presentation for editing.

    • Requires: "presentation_name" (string)
  • save-presentation: Saves the presentation to a file.

    • Requires: "presentation_name" (string)
  • generate-and-save-image: Generates an image using a FLUX model.

    • Requires: "prompt" (string), "file_name" (string)

Configuration

An environment variable is required for image generation via TogetherAI. Register for an account here.

"env": {
    "TOGETHER_API_KEY": "api_key"
}

A folder path is required for saving presentations and images:

"--folder-path",
"/path/to/decks_folder"

Quickstart

Install

Ensure UV is Installed

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Clone the Repository

git clone https://github.com/supercurses/powerpoint.git

Add the Server to Configuration

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following configuration:

"mcpServers": {
    "powerpoint": {
        "command": "uv",
        "env": {
            "TOGETHER_API_KEY": "api_key"
        },
        "args": [
            "--directory",
            "/path/to/powerpoint",
            "run",
            "powerpoint",
            "--folder-path",
            "/path/to/decks_folder"
        ]
    }
}

Usage Examples

  • Create a presentation about fish, including images, tables, and charts.
  • Create a presentation based on a specific paper with given images.
  • Review 2024 Sales Data table and create a presentation showing current trends.

License

This MCP server is licensed under the MIT License, allowing free use, modification, and distribution. For details, see the LICENSE file in the project repository.