Office-PowerPoint-MCP

License Python

Enterprise-Grade PowerPoint Automation Protocol for AI Assistants

Overview

Office-PowerPoint-MCP is a robust Model Context Protocol (MCP) server designed to enable advanced PowerPoint presentation processing capabilities for AI assistants like Claude Code, Amazon Q Developer, and other MCP-compliant clients.

It provides a standardized interface for AI agents to programmatically create, read, manipulate, and analyze Microsoft PowerPoint presentations (.pptx). By abstracting complex presentation object models into clean API tools, it empowers AI assistants to generate professional presentations, reports, and visual documentation workflows autonomously.

Key Benefits

Seamless Integration: Optimized for Claude Code and Amazon Q environments
Rich Formatting: Support for complex layouts, animations, and design controls
Enterprise Ready: Includes template management, media handling, and professional styling
Secure: Runs locally with explicit permission controls

Features

1. Presentation Management

Lifecycle Control: Create, copy, merge, and convert presentations (to PDF)
Structure Analysis: Extract slide content, metadata, and statistics
Template System: Apply and manage custom presentation templates

2. Content Engineering

Advanced Layouts: Create complex slide layouts with multiple content areas
Rich Media: Insert images, videos, charts, and tables with precise positioning
Dynamic Text: Precision control over fonts, colors, and paragraph styles
Interactive Elements: Add animations, transitions, and hyperlinks

3. Design & Styling

Theme Management: Apply and customize presentation themes
Master Slides: Create and modify slide masters for consistent branding
Color Schemes: Implement corporate color palettes and design systems

Getting Started

Prerequisites

Python 3.10 or higher
uv (recommended) or pip package manager
Microsoft PowerPoint (for advanced features)

Installation

Option 1: Using `uvx` (Recommended for ephemeral use)

No installation required. You can run the server directly using uvx.

uvx --from office-powerpoint-mcp-server ppt_mcp_server

Option 2: Local Installation

Clone the repository and install dependencies:

git clone https://github.com/ihatesea69/Office-PowerPoint-MCP.git
cd Office-PowerPoint-MCP
pip install -r requirements.txt

Integration Guide

Claude Code

Add the following to your Claude Code MCP configuration:

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

Amazon Q Developer (VS Code / JetBrains)

To integrate Office-PowerPoint-MCP with Amazon Q Developer:

Open your IDE settings and navigate to Amazon Q > MCP Servers
Add a new server configuration:
- Name: powerpoint-automation
- Command: uvx
- Args: --from, office-powerpoint-mcp-server, ppt_mcp_server
Restart your IDE. Amazon Q will now have access to PowerPoint tools

Other MCP Clients

Add the following to your MCP configuration file:

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

API Reference

The server exposes the following tools to the AI assistant.

Core Operations

Tool Name	Description
`create_presentation`	Create a new blank or template-based presentation
`get_presentation_info`	Extract metadata and structure information
`list_available_presentations`	Scan directory for valid PowerPoint files
`convert_to_pdf`	Export .pptx to PDF format

Content & Formatting

Tool Name	Description
`add_slide`	Insert new slides with specified layouts
`add_text_box`	Add formatted text boxes to slides
`add_image`	Insert images with positioning and scaling
`add_table`	Create structured tables on slides
`add_chart`	Generate charts and graphs

Design Management

Tool Name	Description
`apply_theme`	Apply predefined or custom themes
`set_slide_layout`	Change slide layouts and master templates
`format_text`	Apply advanced text formatting options
`add_animation`	Create slide transitions and animations

Example Usage

# Example: Create a business presentation
presentation = create_presentation("Business Report Q4 2024")
add_slide(presentation, "title_slide", title="Q4 Results", subtitle="Company Performance Review")
add_slide(presentation, "content_slide", title="Key Metrics")
add_chart(presentation, slide_index=1, chart_type="bar", data=sales_data)
apply_theme(presentation, "corporate_blue")
save_presentation(presentation, "Q4_Report.pptx")

Troubleshooting

Common Issues

Permission Denied

Cause: The server cannot access the file system
Fix: Ensure the running process has R/W access to the target directory. On Windows, ensure the file isn't open in Microsoft PowerPoint

Template Not Found

Cause: Using a template that doesn't exist in the system
Fix: Use list_available_templates to see available options, or provide full path to custom templates

Image Insertion Failures

Cause: Relative paths may be ambiguous
Fix: Always use absolute paths for images

Debugging

Set the MCP_DEBUG environment variable to 1 to enable verbose logging:

# Windows (PowerShell)
$env:MCP_DEBUG = "1"

# Linux/Mac
export MCP_DEBUG=1

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License. See LICENSE for details.

Roadmap

Advanced animation support
Integration with online template libraries
Collaborative editing features
AI-powered design suggestions
Support for PowerPoint Online/Office 365

Built for the AI-Powered Productivity Era.

Office-PowerPoint-MCP