Cross-Platform PowerPoint MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cross-Platform PowerPoint MCP Server create a 3-slide presentation about AI benefits and save it as AI_Intro.pptx"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π― Cross-Platform PowerPoint MCP Server
A cross-platform PowerPoint automation server that works with Claude Desktop via the Model Context Protocol (MCP). Create, edit, and manage PowerPoint presentations on Windows, macOS, and Linux using AI assistance.
β¨ Features
π Cross-platform compatibility (Windows, macOS, Linux)
π¨ Complete PowerPoint automation - Create, edit, save presentations
π Intelligent adapter selection - COM API on Windows, python-pptx everywhere else
π€ Claude Desktop integration - Control PowerPoint through natural language
π Rich text manipulation - Add text boxes, update content, set titles
π Advanced techniques support - Perfect for morph transitions and animations
π¦ Easy installation - Available on PyPI
Related MCP server: PPTX MCP Server
π Quick Start
Installation
pip install powerpoint-mcp-serverPlatform-specific notes:
Windows: Optionally install
pywin32for direct PowerPoint COM API accessmacOS/Linux: Uses
python-pptxlibrary (installed automatically)
Claude Desktop Configuration
Add to your Claude Desktop configuration file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
{
"mcpServers": {
"powerpoint": {
"command": "python",
"args": ["-m", "powerpoint_mcp_server"]
}
}
}π¬ Usage Examples
Once configured, interact with PowerPoint through Claude Desktop:
π€ What platform am I running on and what PowerPoint adapter is available?
π€ Please create a new PowerPoint presentation with a title slide called "AI-Powered Presentations"
π€ Add a content slide explaining the benefits of cross-platform automation
π€ Save the presentation to ~/Documents/my-ai-presentation.pptxπ§ Available Functions
Core Operations
initialize_powerpoint()- Initialize PowerPoint connectionget_platform_info()- Get system and adapter informationcreate_presentation()- Create new presentationopen_presentation(path)- Open existing presentationsave_presentation(id, path)- Save presentationclose_presentation(id)- Close presentation
Slide Management
get_slides(presentation_id)- List all slidesadd_slide(presentation_id, layout_type)- Add new slideget_slide_text(presentation_id, slide_id)- Extract slide textset_slide_title(presentation_id, slide_id, title)- Set slide title
Content Editing
add_text_box(presentation_id, slide_id, text, ...)- Add text boxupdate_text(presentation_id, slide_id, shape_id, text)- Update text content
π₯οΈ Platform Support
Feature | Windows + PowerPoint | Windows (python-pptx) | macOS | Linux |
Create presentations | β | β | β | β |
Edit presentations | β | β | β | β |
Live PowerPoint control | β | β | β | β |
File-based operations | β | β | β | β |
Morph transitions* | β | β | β | β |
*Morph transitions require PowerPoint Desktop for playback
π Advanced Use Cases
This MCP server is perfect for:
AI-assisted presentation creation
Batch processing PowerPoint files
Cross-platform presentation workflows
Advanced animation techniques (liquid masks, morph effects)
Automated content generation
Educational presentation tools
ποΈ Architecture
βββββββββββββββββββ ββββββββββββββββββββ βββββββββββββββββββ
β Claude Desktop βββββΊβ MCP Protocol βββββΊβ This Server β
βββββββββββββββββββ ββββββββββββββββββββ βββββββββββββββββββ
β
βΌ
βββββββββββββββββββ
β Platform Detect β
βββββββββββββββββββ
β
ββββββββββββββββββββββΌβββββββββββββββββββββ
βΌ βΌ βΌ
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β Windows COM API β β python-pptx β β Fallback Handlerβ
β (pywin32) β β (Cross-platform)β β (No adapter) β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββπ οΈ Development
Setup Development Environment
# Clone repository
git clone https://github.com/your-username/powerpoint-mcp-server.git
cd powerpoint-mcp-server
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install in development mode
pip install -e ".[dev]"Running Tests
pytestBuilding Package
python -m buildπ Requirements
Python 3.10+
Claude Desktop client
Optional: PowerPoint Desktop (for live control on Windows)
π€ Contributing
Contributions are welcome! Please see our Contributing Guide.
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureMake your changes and add tests
Commit:
git commit -m 'Add amazing feature'Push:
git push origin feature/amazing-featureOpen a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Acknowledgments
Model Context Protocol (MCP) - Communication protocol
python-pptx - Cross-platform PowerPoint library
pywin32 - Windows COM API access
Claude Desktop - AI-powered automation platform
π Support
Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: Project Wiki
Made with β€οΈ for the Claude Desktop community
Available Tools
13 toolsadd_slideA
Add a new slide to the presentation.
Args:
presentation_id: ID of the presentation
layout_type: Slide layout type (default is 1, title slide)
1: ppLayoutTitle (title slide)
2: ppLayoutText (slide with title and text)
3: ppLayoutTwoColumns (two-column slide)
7: ppLayoutBlank (blank slide)
etc...
Returns:
Information about the new slide
Inputs: presentation_id (required), layout_type. Returns: result
add_text_boxA
Add a text box to a slide and set its text content.
Args:
presentation_id: ID of the presentation
slide_id: ID of the slide (numeric string)
text: Text content
left: Left edge position of the text box (points)
top: Top edge position of the text box (points)
width: Width of the text box (points)
height: Height of the text box (points)
Returns:
Operation status and ID of the new shape
Inputs: presentation_id (required), slide_id (required), text (required), left, +3 more. Returns: result
close_presentationC
Close a presentation.
Args:
presentation_id: ID of the presentation
save: Whether to save changes before closing
Returns:
Status of the operation
Inputs: presentation_id (required), save. Returns: result
create_presentationB
Create a new PowerPoint presentation.
Returns:
Dictionary containing new presentation ID and metadata
Inputs: no named parameters. Returns: result
get_platform_infoB
Get information about the current platform and available PowerPoint adapters.
Returns:
Platform and adapter information
Inputs: no named parameters. Returns: result
get_presentationsB
Get a list of all open PowerPoint presentations with their metadata.
Inputs: no named parameters. Returns: result
get_slidesC
Get a list of all slides in a presentation.
Args:
presentation_id: ID of the presentation
Returns:
List of slide metadata
Inputs: presentation_id (required). Returns: result
get_slide_textB
Get all text content in a slide.
Args:
presentation_id: ID of the presentation
slide_id: ID of the slide (integer)
Returns:
Dictionary containing text content organized by shape
Inputs: presentation_id (required), slide_id (required). Returns: result
initialize_powerpointB
Initialize connection to PowerPoint.
Returns:
Status of initialization and platform information
Inputs: no named parameters. Returns: result
open_presentationB
Open a PowerPoint presentation from the specified path.
Args:
path: Full path to the PowerPoint file (.pptx, .ppt)
Returns:
Dictionary with presentation ID and metadata
Inputs: path (required). Returns: result
save_presentationB
Save a presentation to disk.
Args:
presentation_id: ID of the presentation
path: Optional path to save the file (if None, save to current location)
Returns:
Status of the operation
Inputs: presentation_id (required), path. Returns: result
set_slide_titleB
Set the title text of a slide.
Args:
presentation_id: ID of the presentation
slide_id: ID of the slide (numeric string)
title: New title text
Returns:
Status of the operation
Inputs: presentation_id (required), slide_id (required), title (required). Returns: result
update_textC
Update the text content of a shape.
Args:
presentation_id: ID of the presentation
slide_id: ID of the slide (numeric string)
shape_id: ID of the shape (numeric string)
text: New text content
Returns:
Status of the operation
Inputs: presentation_id (required), slide_id (required), shape_id (required), text (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 13 tools
Most tools have distinct purposes, but there is some overlap between add_text_box and update_text that could cause confusion. add_text_box creates a new text box with content, while update_text modifies existing text in a shape, but both involve text manipulation on slides. Other tools like create_presentation, open_presentation, and close_presentation are clearly differentiated.
All tool names follow a consistent verb_noun pattern using snake_case, such as add_slide, get_slides, and save_presentation. The naming is predictable and uniform throughout the set, making it easy for agents to understand the action and target.
With 13 tools, the server is well-scoped for PowerPoint operations, covering presentation lifecycle, slide management, and text editing. Each tool serves a clear purpose without redundancy, and the count is appropriate for the domain, allowing comprehensive control without being overwhelming.
The tool set provides strong coverage for core PowerPoint tasks, including CRUD operations for presentations and slides, and text manipulation. However, there are minor gaps, such as missing tools for adding images, shapes, or charts, and no direct way to delete slides or shapes, which agents might need to work around.
Maintenance
Related MCP Connectors
Generate AI slide decks and export native PowerPoint (.pptx) and PDF presentations from chat.
Generate professional PowerPoint presentations from text, YouTube videos, or structured JSON data.β¦
Create professionally designed, editable PowerPoint presentations from a prompt.
Generate, edit, merge, translate and PDF-convert PowerPoint (.pptx) over MCP. 8 tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceCreates and manipulates PowerPoint presentations with capabilities for adding various slide types, generating images, and incorporating tables and charts through natural language commands.11145MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to create, edit, and manipulate PowerPoint presentations programmatically with support for text styling, shapes, slide rearrangement, and direct Office XML access.81-
- AlicenseNot gradedqualityDmaintenanceEnables PowerPoint automation on Windows, including template-based creation, real-time editing, LaTeX equations, animations, and multimodal slide analysis, all via natural language.156 PyPI130MIT
- AlicenseAqualityDmaintenanceEnables AI-powered slide deck creation using natural language, allowing users to generate, edit, and manage presentations through MCP clients like Cursor and Claude Code.1414 npmMIT