Office PowerPoint MCP server

Enables creation and manipulation of PowerPoint presentations with tools for adding and formatting slides, text, images, tables, charts and shapes through python-pptx
Back to servers
Setup instructions
Provider
gongrzhe
Release date
Mar 25, 2025
Language
Python
Package
Stats
12.8K downloads
512 stars

The PowerPoint MCP Server is a comprehensive tool for creating and manipulating PowerPoint presentations through the Model Context Protocol. It offers 32 powerful tools organized into 11 modules, providing complete control over PowerPoint creation, management, and professional design capabilities.

Installation

Via Smithery

Install the PowerPoint MCP Server for Claude Desktop automatically:

npx -y @smithery/cli install @GongRzhe/Office-PowerPoint-MCP-Server --client claude

Prerequisites

  • Python 3.6 or higher
  • pip package manager
  • Optional: uvx for package execution without local installation

Using the Setup Script (Recommended)

The easiest installation method is using the provided setup script:

python setup_mcp.py

This script will:

  • Check prerequisites
  • Offer installation options (PyPI or local development)
  • Install required dependencies
  • Generate the appropriate MCP configuration
  • Provide instructions for Claude Desktop integration

Manual Installation

  1. Clone the repository:

    git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
    cd Office-PowerPoint-MCP-Server
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Make the server executable:

    chmod +x ppt_mcp_server.py
    

Usage

Starting the Server

Run the stdio server:

python ppt_mcp_server.py

Run the streamable-http server:

python ppt_mcp_server.py --transport http --port 8000

Run in Docker:

docker build -t ppt_mcp_server .
docker run -d --rm -p 8000:8000 ppt_mcp_server -t http

MCP Configuration

Local Python Server

Add to your MCP settings:

{
  "mcpServers": {
    "ppt": {
      "command": "python",
      "args": ["/path/to/ppt_mcp_server.py"],
      "env": {}
    }
  }
}

Using UVX (No Local Installation)

{
  "mcpServers": {
    "ppt": {
      "command": "uvx",
      "args": [
        "--from", "office-powerpoint-mcp-server", "ppt_mcp_server"
      ],
      "env": {}
    }
  }
}

Key Features

Core PowerPoint Operations

  • Round-trip support for any Open XML presentation
  • Template support with theme preservation
  • Multi-presentation management
  • Document properties management

Content Creation & Management

  • Slide management with flexible layouts
  • Text manipulation with placeholder population
  • Advanced text formatting with font, color, and style controls
  • Text validation with automatic fit checking

Visual Elements

  • Image handling with enhancement capabilities
  • Professional image effects (shadows, reflections, glows)
  • Shape creation with 20+ auto shape types
  • Table creation with advanced formatting

Professional Design Features

  • 4 professional color schemes
  • Professional typography with Segoe UI font family
  • Theme application across presentations
  • Gradient backgrounds with customizable colors
  • 25 built-in slide templates with dynamic features

Examples

Creating a New Presentation

# Create a new presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation",
    arguments={}
)
presentation_id = result["presentation_id"]

# Add a title slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,  # Title slide layout
        "title": "My Presentation",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# Populate subtitle placeholder
result = use_mcp_tool(
    server_name="ppt",
    tool_name="populate_placeholder",
    arguments={
        "slide_index": slide_index,
        "placeholder_idx": 1,  # Subtitle placeholder
        "text": "Created with PowerPoint MCP Server",
        "presentation_id": presentation_id
    }
)

# Save the presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="save_presentation",
    arguments={
        "file_path": "my_presentation.pptx",
        "presentation_id": presentation_id
    }
)

Using Professional Design Features

# Create a professional slide with modern styling
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_professional_design",
    arguments={
        "operation": "slide",
        "slide_type": "title_content",
        "color_scheme": "modern_blue",
        "title": "Quarterly Business Review",
        "content": [
            "Revenue increased by 15% compared to last quarter",
            "Customer satisfaction scores reached all-time high of 94%",
            "Successfully launched 3 new product features",
            "Expanded team by 12 new talented professionals"
        ]
    }
)

# Apply professional theme to entire presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_professional_design",
    arguments={
        "operation": "theme",
        "color_scheme": "modern_blue",
        "apply_to_existing": True
    }
)

Working with Slide Templates

# List all available slide templates
result = use_mcp_tool(
    server_name="ppt",
    tool_name="list_slide_templates",
    arguments={}
)

# Create a new slide using a template
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_slide_from_template",
    arguments={
        "template_id": "text_with_image",
        "color_scheme": "elegant_green",
        "content_mapping": {
            "title": "Our Revolutionary Solution",
            "content": "• 250% increase in efficiency\n• 98% customer satisfaction\n• Industry-leading performance"
        },
        "image_paths": {
            "supporting": "path/to/product_image.jpg"
        }
    }
)

# Generate a complete presentation from multiple templates
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation_from_templates",
    arguments={
        "template_sequence": [
            {
                "template_id": "title_slide",
                "content": {
                    "title": "2024 Annual Report",
                    "subtitle": "Growth and Innovation",
                    "author": "Executive Team"
                }
            },
            {
                "template_id": "key_metrics_dashboard",
                "content": {
                    "metric_1_value": "94%",
                    "metric_2_value": "$2.4M",
                    "metric_3_value": "247"
                }
            }
        ],
        "color_scheme": "modern_blue"
    }
)

Enhanced Image Management

# Add image with automatic enhancement
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_image",
    arguments={
        "slide_index": 1,
        "operation": "add",
        "image_source": "company_logo.png",
        "left": 1.0,
        "top": 1.0,
        "width": 3.0,
        "height": 2.0,
        "enhancement_style": "presentation"
    }
)

# Apply multiple picture effects at once
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_picture_effects",
    arguments={
        "slide_index": 1,
        "shape_index": 0,
        "effects": {
            "shadow": {
                "shadow_type": "outer",
                "blur_radius": 4.0,
                "distance": 3.0,
                "direction": 315.0,
                "color": [128, 128, 128],
                "transparency": 0.6
            },
            "glow": {
                "size": 5.0,
                "color": [0, 176, 240],
                "transparency": 0.4
            }
        }
    }
)

Advanced Text Management

# Add and format text in one operation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "add",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0,
        "height": 1.5,
        "text": "Welcome to Our Quarterly Review",
        "font_size": 32,
        "font_name": "Segoe UI",
        "bold": True,
        "color": [0, 120, 215],
        "alignment": "center",
        "auto_fit": True
    }
)

# Validate and fix text fit issues
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "validate",
        "shape_index": 0,
        "validation_only": False,  # Auto-fix enabled
        "min_font_size": 10,
        "max_font_size": 48
    }
)

Working with Charts

# Add a column chart with comprehensive customization
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_chart",
    arguments={
        "slide_index": slide_index,
        "chart_type": "column",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0,
        "height": 4.5,
        "categories": ["Q1", "Q2", "Q3", "Q4"],
        "series_names": ["2023", "2024"],
        "series_values": [
            [100, 120, 140, 160],
            [110, 130, 150, 170]
        ],
        "has_legend": True,
        "legend_position": "bottom",
        "has_data_labels": True,
        "title": "Quarterly Sales Performance"
    }
)

Template Support

Working with Templates

The server provides comprehensive template support with features including:

  • Corporate branding with predefined themes and layouts
  • Consistent presentations across teams
  • Custom slide masters and specialized layouts
  • Configurable template search paths

Template Configuration

Set the PPT_TEMPLATE_PATH environment variable for custom template directories:

# Unix/Linux/macOS
export PPT_TEMPLATE_PATH="/path/to/templates:/another/path"

# Windows  
set PPT_TEMPLATE_PATH="C:\templates;C:\company_templates"

Built-in Slide Templates

The server includes 25 professional slide templates with dynamic features:

Dynamic Features

  • Automatic text sizing based on content length
  • Intelligent text wrapping
  • Visual effects including shadows, glows, and outlines
  • Gradient backgrounds with multi-layer compositions
  • Professional animations for presentation delivery

Template Categories

  • Title & Introduction: title_slide, chapter_intro, thank_you_slide
  • Content Layout: text_with_image, two_column_text, three_column_layout
  • Business & Analytics: key_metrics_dashboard, before_after_comparison
  • Process & Flow: process_flow, agenda_slide, timeline_slide
  • Team & Organization: team_introduction

Color Schemes

Four professional color schemes are available:

  • modern_blue: Microsoft-inspired theme with dynamic gradients
  • corporate_gray: Professional grayscale with blue accents
  • elegant_green: Forest green with cream and light accents
  • warm_red: Deep red with orange and yellow highlights

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "ppt" '{"command":"uvx","args":["--from","office-powerpoint-mcp-server","ppt_mcp_server"],"env":[]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "ppt": {
            "command": "uvx",
            "args": [
                "--from",
                "office-powerpoint-mcp-server",
                "ppt_mcp_server"
            ],
            "env": []
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "ppt": {
            "command": "uvx",
            "args": [
                "--from",
                "office-powerpoint-mcp-server",
                "ppt_mcp_server"
            ],
            "env": []
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later