Office-PowerPoint-MCP-Server MCP Server

Overview

The Office-PowerPoint-MCP-Server is a Model Context Protocol server designed for PowerPoint manipulation using python-pptx. Version 2.0 provides thirty-two tools organized into eleven specialized modules, offering complete capabilities for PowerPoint creation, management, and professional design. The software features a modular architecture with enhanced parameter handling, intelligent operation selection, and comprehensive error handling. It supports round-trip operations for any Open XML presentation file, template management with automatic theme preservation, and multi-presentation tracking.

The server includes core document properties management, slide layout selection, text manipulation, and advanced formatting controls for fonts, colors, and alignment. Visual elements are supported through image handling, Pillow-based image enhancement, professional image effects, and shape creation with more than twenty auto shape types. Additional capabilities include table creation, chart support for various data visualizations, and professional design features such as color schemes, typography, gradient backgrounds, and built-in slide templates.

What it can do

The README lists these tools and features:

• 4 professional color schemes (Modern Blue, Corporate Gray, Elegant Green, Warm Red)
• Professional typography with Segoe UI font family and size presets
• Theme application with automatic styling across presentations
• Gradient backgrounds with customizable directions and color schemes
• Slide enhancement tools for existing content
• 25 built-in slide templates with dynamic sizing and visual effects
• Advanced template features including auto-wrapping, dynamic font sizing, and professional animations
• Font analysis and optimization using FontTools
• Picture effects with 9 different visual effects (shadow, reflection, glow, bevel, etc.)
• Comprehensive validation with automatic error fixing
• Template search with configurable directory paths
• Professional layout calculations with margin and spacing management
• Complete PowerPoint manipulation with 34 specialized tools
• 11 organized modules covering all aspects of presentation creation
• Enhanced parameter handling with comprehensive validation
• Intelligent defaults and operation-based interfaces
• Automatic text sizing based on content length and container dimensions
• Intelligent text wrapping to fit within specified areas
• Visual effects including shadows, glows, and outlines
• Gradient backgrounds with multi-layer compositions
• Professional animations ready for presentation delivery
• Interactive hover effects for enhanced user experience
• Smart content overflow handling with automatic adjustments
• manage_hyperlinks - Complete hyperlink management for text elements
• update_chart_data - Advanced chart data replacement and updating

The server operates through a modular architecture consisting of eleven specialized modules that cover presentation, content, structural, professional, template, hyperlink, chart, connector, master, and transition tools. It utilizes python-pptx for manipulating Open XML presentation files and incorporates FontTools for font analysis and optimization. Image handling features are powered by Pillow to provide adjustments such as brightness, contrast, saturation, and filter controls alongside nine different visual effects like shadows, reflections, glows, bevels, and soft edges.

Users can run the server locally using Python or via a setup script that automates prerequisite checks, environment options, and dependency installation. The application supports starting a standard input output server or a streamable HTTP server on a specified port. Alternatively, users can execute the package using uvx for running without local installation or deploy it inside a container using Docker.

Install and configure

These commands were found in the project's own README. We checked each package name against the public registry.

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

(@smithery/cli found on npm, latest 4.11.1)

pip install -r requirements.txt

(requirements.txt was NOT found on the PyPI registry: do not run this until you have checked the project)

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

(not a registry package: check the source before running it)

Environment variables:

Requirements

The Python package requires Python >=3.6. The README mentions setup for these clients: Claude Desktop, Zed.

Use cases

Users can create complete PowerPoint presentations from scratch or manage existing Open XML presentation files while preserving all elements, themes, and layouts. The server allows management of core document properties such as titles, subjects, authors, keywords, and comments, alongside flexible slide management and layout selection. Content creation workflows benefit from placeholder population, bullet point generation, and advanced text formatting controls.

Professionals can build visually enhanced slides by incorporating images with base64 or file inputs, applying Pillow-based enhancements, and adding shape creations, tables, and data visualizations including column, bar, line, and pie charts. The design features allow the application of built-in color schemes, typography presets, gradient backgrounds, and professional slide templates equipped with auto-wrapping, dynamic font sizing, and visual effects.

This server is intended for developers and users who want to automate PowerPoint presentation creation, manipulation, and professional design tasks using the Model Context Protocol through client applications like Claude Desktop.

Limitations and things to check

Prerequisites include Python version 3.6 or higher and the pip package manager, though a documentation issue notes a discrepancy regarding the minimum Python version. Users have reported issues regarding saved presentation files not being found after creation, trouble saving generated presentation files, and inquiries regarding importing three-dimensional models. The documentation does not specify additional system constraints beyond these runtime requirements and known user-reported issues.

Before use, operators should review configuration settings for local Python execution or uvx setups, ensuring proper command paths and environment variables are correctly mapped. The documentation does not state whether specific operating systems are required or if third-party graphics libraries beyond Pillow and FontTools are needed for advanced visual effects.

Before you connect it:

• The README mentions: can run commands or code on your machine; manages infrastructure or cloud resources.
• Read the code or the documentation of the tools it exposes, and note what each tool can do.
• Grant the smallest permissions you can: limit folders, API scopes and database roles.
• Keep credentials in environment variables or a secrets manager, never in a shared config file.
• Run it in a container or a separate user account if it can execute code or touch files.

Release history

The most recent releases published on GitHub:

• v2.0.7 (2025-12-31): ## What's New - Added GitHub Actions workflow for automatic PyPI publishing - Improved MCP tool annotations support - Fixed shape mapping issues - Enhanced code quality and documentation ## Full Changelog https://github.com/GongRzhe/Office-PowerPoint-MCP-Server/compare/v2.0.6...v2.0.7

Known issues and troubleshooting

These are the most discussed threads on the project's issue tracker. They show what other users ran into; read them before you install, and check whether they are still open.

• Where is the saved presentation file? (open, 7 comments)
• Presentation not found after creation when using MCP server (open, 4 comments)
• The generated ppt file can't be saved (open, 3 comments)
• import 3D model (open, 3 comments)
• README has wrong minimum python version (open, 3 comments)

Maintenance and community

The repository has 10 contributors, 4 commits in the last 12 months, 27 open issues and pull requests. It is maintained by GongRzhe, a GitHub user with 50 public repositories and 136 followers. GitHub's community checks found no security policy file, no contribution guidelines, no code of conduct. The npm package has 1 maintainers, 0 direct dependencies and was downloaded 5,163 times in the last week.

Frequently asked questions

Is Office-PowerPoint-MCP-Server free to use?

The repository is released under the MIT license.

When was Office-PowerPoint-MCP-Server last updated?

The last commit was on 2025-12-31, and the project is archived.

Which AI clients does Office-PowerPoint-MCP-Server work with?

Its README gives setup notes for Claude Desktop, Zed. Other MCP-compatible clients may also work, but the project does not say so.

What is the Office-PowerPoint-MCP-Server?

It is an MCP server for PowerPoint manipulation utilizing python-pptx, offering multiple specialized tools and modules for presentation creation, management, and design.

How can the server be installed?

It can be installed automatically via Smithery for Claude Desktop, through a setup script, or manually by cloning the repository and installing dependencies.

What transport options are available for running the server?

The server can run as a standard input output server or as a streamable HTTP server on port 8000, and it can also run inside a Docker container.

What features are included for visual elements?

The server supports image handling with file and base64 inputs, Pillow-based enhancements, professional image effects, table creation, and chart management.

Sources

This page combines data from:

• Office-PowerPoint-MCP-Server on GitHub
• npm package @smithery/cli