Office-PowerPoint-MCP-Server

What is Office-PowerPoint-MCP-Server?

Office-PowerPoint-MCP-Server is a comprehensive Model Context Protocol (MCP) server designed for advanced PowerPoint manipulation using the python-pptx library. It provides a robust set of tools to programmatically create, read, edit, and manage Microsoft PowerPoint presentations. Version 2.0 significantly expands its capabilities with 32 specialized tools organized into 11 modules, focusing on complete presentation creation, management, and professional design.

How to Use Office-PowerPoint-MCP-Server?

Installation:

1. Via Smithery (Recommended for Claude Desktop):

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

2. Using Setup Script:

   python setup_mcp.py
   

   This script automates prerequisite checks, offers installation options (PyPI or local development), installs dependencies, and generates the MCP configuration.
3. Manual Installation:

   git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
   cd Office-PowerPoint-MCP-Server
   pip install -r requirements.txt
   chmod +x ppt_mcp_server.py
   

Running the Server:

• Stdio Server: python ppt_mcp_server.py
• Streamable-Http Server (on port 8000): python ppt_mcp_server.py --transport http --port 8000
• Docker:

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

MCP Configuration:

Integrate with your MCP settings by adding server configurations (e.g., for local Python server or using uvx for direct PyPI execution).

Example Usage (Python):

Interact with the server using use_mcp_tool to call specific functions:

# 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": "My Presentation",
        "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
    }
)

Key Features of Office-PowerPoint-MCP-Server

• Comprehensive Tool Suite (32 Tools): Complete PowerPoint manipulation with specialized tools covering all aspects of presentation creation and management.
• Modular Architecture: 11 specialized modules (presentation, content, template, structural, professional, etc.) and 7 utility modules for clear separation of concerns, maintainability, and extensibility.
• Core PowerPoint Operations: Round-trip support for .pptx files, template support with theme preservation, multi-presentation management, and core document properties management.
• Content Creation & Management: Flexible slide management, text manipulation (placeholders, bullet points, advanced formatting, validation), image handling (file/base64, enhancement, professional effects), shape creation, and table creation.
• Charts & Data Visualization: Support for various chart types (column, bar, line, pie), data series management, and chart formatting.
• Professional Design Features: 4 built-in professional color schemes (Modern Blue, Corporate Gray, Elegant Green, Warm Red), professional typography, theme application, gradient backgrounds, and slide enhancement tools.
• Built-in Slide Templates (25+): Professional slide templates with dynamic features like automatic text sizing, intelligent text wrapping, visual effects, gradient backgrounds, and professional animations.
• Advanced Features: Font analysis and optimization, comprehensive validation with auto-fixing, template search, and professional layout calculations.
• Unified Tools (v2.0): Consolidated tools like manage_text, manage_image, apply_picture_effects, and apply_professional_design for streamlined operations.
• New Specialized Tools (v2.0): Hyperlink management, advanced chart data updating, connector lines, slide master management, basic slide transitions, AI-powered presentation generation (auto_generate_presentation), and text optimization (optimize_slide_text).

Use Cases of Office-PowerPoint-MCP-Server

• Automated Report Generation: Automatically create professional PowerPoint reports from data sources.
• Dynamic Presentation Creation: Generate presentations on the fly based on user input or specific topics.
• Branded Content Production: Ensure consistent corporate branding across all presentations using templates and themes.
• Mass Presentation Updates: Efficiently update content, formatting, or design elements across multiple presentations.
• Integration with AI/Automation Workflows: Serve as a backend for AI models or automation scripts to generate and manipulate PowerPoint files.
• Custom Presentation Tools: Develop custom applications that require programmatic control over PowerPoint.
• Data Visualization: Create charts and tables directly in presentations from raw data.

FAQ from Office-PowerPoint-MCP-Server

Q: What are the prerequisites for running the server? A: Python 3.6 or higher and pip package manager. uvx is optional for package execution without local installation.

Q: How can I specify custom template directories? A: Set the PPT_TEMPLATE_PATH environment variable to your desired directories.

Q: What kind of templates does the server support? A: It supports .pptx and .potx files, including those with existing content and custom layouts. It also includes 25+ built-in professional slide templates.

Q: Can I apply multiple picture effects at once? A: Yes, with the apply_picture_effects tool, you can apply combined effects like shadow, glow, and rotation in a single call.

Q: Does the server support text validation and auto-fixing? A: Yes, the manage_text tool includes operations for validating text fit and can automatically fix issues by adjusting font sizes.

Q: How does the server handle professional design? A: It offers 4 built-in color schemes, professional typography, theme application, gradient backgrounds, and a unified apply_professional_design tool for managing themes, slides, and enhancements.

Q: What is the Model Context Protocol (MCP)? A: MCP is a protocol that allows applications to interact with specialized servers, like this PowerPoint server, to perform specific tasks. This server implements MCP to enable programmatic control over PowerPoint.

Office-PowerPoint-MCP-Server

A comprehensive MCP (Model Context Protocol) server for PowerPoint manipulation using python-pptx. Version 2.0 provides 32 powerful tools organized into 11 specialized modules, offering complete PowerPoint creation, management, and professional design capabilities. The server features a modular architecture with enhanced parameter handling, intelligent operation selection, and comprehensive error handling.

---

Not so ugly anymore with new slide_layout_templates

---

Example

Pormpt

Output

Demo's GIF -> (./public/demo.mp4)

Features

Core PowerPoint Operations

• Round-trip support for any Open XML presentation (.pptx file) including all elements
• Template support with automatic theme and layout preservation
• Multi-presentation management with global state tracking
• Core document properties management (title, subject, author, keywords, comments)

Content Creation & Management

• Slide management with flexible layout selection
• Text manipulation with placeholder population and bullet point creation
• Advanced text formatting with font, color, alignment, and style controls
• Text validation with automatic fit checking and optimization suggestions

Visual Elements

• Image handling with file and base64 input support
• Image enhancement using Pillow with brightness, contrast, saturation, and filter controls
• Professional image effects including shadows, reflections, glows, and soft edges
• Shape creation with 20+ auto shape types (rectangles, ovals, flowchart elements, etc.)
• Table creation with advanced cell formatting and styling

Charts & Data Visualization

• Chart support for column, bar, line, and pie charts
• Data series management with categories and multiple series support
• Chart formatting with legends, data labels, and titles

Professional Design 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

Advanced Features

• 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

Installation

Installing via Smithery

To install PowerPoint Manipulation Server for Claude Desktop automatically via Smithery:

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

Prerequisites

• Python 3.6 or higher (as specified in pyproject.toml)
• pip package manager
• Optional: uvx for package execution without local installation

Installation Options

Option 1: Using the Setup Script (Recommended)

The easiest way to set up the PowerPoint MCP Server is using the provided setup script, which automates the installation process:

python setup_mcp.py

This script will:

• Check prerequisites
• Offer installation options:
  • Install from PyPI (recommended for most users)
  • Set up local development environment
• Install required dependencies
• Generate the appropriate MCP configuration file
• Provide instructions for integrating with Claude Desktop

The script offers different paths based on your environment:

• If you have uvx installed, it will configure using UVX (recommended)
• If the server is already installed, it provides configuration options
• If the server is not installed, it offers installation methods

Option 2: 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

Display help text:

python ppt_mcp_server.py -h

Starting the Stdio Server

Run the stdio server:

python ppt_mcp_server.py

Starting the Streamable-Http Server

Run the streamable-http server on port 8000:

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

Option 1: Local Python Server

Add the server to your MCP settings configuration file:

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

Option 2: Using UVX (No Local Installation Required)

If you have uvx installed, you can run the server directly from PyPI without local installation:

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

🚀 What's New in v2.0

Comprehensive Tool Suite (32 Tools)

• Complete PowerPoint manipulation with 32 specialized tools
• 11 organized modules covering all aspects of presentation creation
• Enhanced parameter handling with comprehensive validation
• Intelligent defaults and operation-based interfaces

Built-in Slide Templates

• 25+ professional slide templates with dynamic features built-in
• Advanced template system with auto-generation capabilities
• Auto-sizing text that adapts to content length and container size
• Professional visual effects including shadows, glows, and gradients
• Complete presentation generation from template sequences

Modular Architecture

• 11 specialized modules: presentation, content, structural, professional, template, hyperlink, chart, connector, master, and transition tools
• Better maintainability with separated concerns
• Easier extensibility for adding new features
• Cleaner code structure with shared utilities

Available Tools

The server provides 32 specialized tools organized into the following categories:

Presentation Management (7 tools)

1. create_presentation - Create new presentations
2. create_presentation_from_template - Create from templates with theme preservation
3. open_presentation - Open existing presentations
4. save_presentation - Save presentations to files
5. get_presentation_info - Get comprehensive presentation information
6. get_template_file_info - Analyze template files and layouts
7. set_core_properties - Set document properties

Content Management (6 tools)

8. add_slide - Add slides with optional background styling
9. get_slide_info - Get detailed slide information
10. populate_placeholder - Populate placeholders with text
11. add_bullet_points - Add formatted bullet points
12. manage_text - ✨ Unified text tool (add/format/validate/format_runs)
13. manage_image - ✨ Unified image tool (add/enhance)

Template Operations (7 tools)

14. list_slide_templates - Browse available slide layout templates
15. apply_slide_template - Apply structured layout templates to existing slides
16. create_slide_from_template - Create new slides using layout templates
17. create_presentation_from_templates - Create complete presentations from template sequences
18. get_template_info - Get detailed information about specific templates
19. auto_generate_presentation - Automatically generate presentations based on topic
20. optimize_slide_text - Optimize text elements for better readability and fit

Structural Elements (4 tools)

21. add_table - Create tables with enhanced formatting
22. format_table_cell - Format individual table cells
23. add_shape - Add shapes with text and formatting options
24. add_chart - Create charts with comprehensive customization

Professional Design (3 tools)

25. apply_professional_design - ✨ Unified design tool (themes/slides/enhancement)
26. apply_picture_effects - ✨ Unified effects tool (9+ effects combined)
27. manage_fonts - ✨ Unified font tool (analyze/optimize/recommend)

Specialized Features (5 tools)

28. manage_hyperlinks - Complete hyperlink management (add/remove/list/update)
29. manage_slide_masters - Access and manage slide master properties and layouts
30. add_connector - Add connector lines/arrows between points on slides
31. update_chart_data - Replace existing chart data with new categories and series
32. manage_slide_transitions - Basic slide transition management

🌟 Key Unified Tools

manage_text - All-in-One Text Management

# Add text box
manage_text(slide_index=0, operation="add", text="Hello World", font_size=24)

# Format existing text
manage_text(slide_index=0, operation="format", shape_index=0, bold=True, color=[255,0,0])

# Validate text fit with auto-fix
manage_text(slide_index=0, operation="validate", shape_index=0, validation_only=False)

manage_image - Complete Image Handling

# Add image with enhancement
manage_image(slide_index=0, operation="add", image_source="logo.png", 
            enhancement_style="presentation")

# Enhance existing image
manage_image(slide_index=0, operation="enhance", image_source="photo.jpg",
            brightness=1.2, contrast=1.1, saturation=1.3)

apply_picture_effects - Multiple Effects in One Call

# Apply combined effects
apply_picture_effects(slide_index=0, shape_index=0, effects={
    "shadow": {"blur_radius": 4.0, "color": [128,128,128]},
    "glow": {"size": 5.0, "color": [0,176,240]},
    "rotation": {"rotation": 15.0}
})

apply_professional_design - Theme & Design Management

# Add professional slide
apply_professional_design(operation="slide", slide_type="title_content", 
                         color_scheme="modern_blue", title="My Presentation")

# Apply theme to entire presentation  
apply_professional_design(operation="theme", color_scheme="corporate_gray")

# Enhance existing slide
apply_professional_design(operation="enhance", slide_index=0, color_scheme="elegant_green")

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
    }
)

Creating a Professional Presentation with v2.0

# Create a professional slide with modern styling - CONSOLIDATED TOOL
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 - SAME TOOL, DIFFERENT OPERATION
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_professional_design",
    arguments={
        "operation": "theme",
        "color_scheme": "modern_blue",
        "apply_to_existing": True
    }
)

# Add slide with gradient background - ENHANCED ADD_SLIDE
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,
        "background_type": "professional_gradient",
        "color_scheme": "modern_blue",
        "gradient_direction": "diagonal"
    }
)

Working with Built-in Slide Templates (New in v2.0)

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

# Apply a professional template to an existing slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_slide_template",
    arguments={
        "slide_index": 0,
        "template_id": "title_slide",
        "color_scheme": "modern_blue",
        "content_mapping": {
            "title": "Quarterly Business Review",
            "subtitle": "Q4 2024 Results",
            "author": "Leadership Team"
        }
    }
)

# 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"
                }
            },
            {
                "template_id": "before_after_comparison",
                "content": {
                    "content_left": "Manual processes taking hours",
                    "content_right": "Automated workflows in minutes"
                }
            }
        ],
        "color_scheme": "modern_blue"
    }
)

Enhanced Image Management with v2.0

# Add image with automatic enhancement - CONSOLIDATED TOOL
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 - CONSOLIDATED TOOL
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 with v2.0

# Add and format text in one operation - CONSOLIDATED TOOL
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 - SAME TOOL, DIFFERENT OPERATION
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
    }
)

Creating a Presentation from Template

# First, inspect a template to see its layouts and properties
result = use_mcp_tool(
    server_name="ppt",
    tool_name="get_template_info",
    arguments={
        "template_path": "company_template.pptx"
    }
)
template_info = result

# Create a new presentation from the template
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation_from_template",
    arguments={
        "template_path": "company_template.pptx"
    }
)
presentation_id = result["presentation_id"]

# Add a slide using one of the template's layouts
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 1,  # Use layout from template
        "title": "Quarterly Report",
        "presentation_id": presentation_id
    }
)

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

Adding Advanced Charts and Data Visualization

# Add a chart slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 1,  # Content slide layout
        "title": "Sales Data",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# 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",
        "presentation_id": presentation_id
    }
)

Text Validation and Optimization with v2.0

# Validate text fit and get optimization suggestions - USING CONSOLIDATED TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "validate",
        "shape_index": 0,
        "text": "This is a very long title that might not fit properly in the designated text box area",
        "font_size": 24,
        "validation_only": True
    }
)

# Comprehensive slide validation with automatic fixes - SAME TOOL, AUTO-FIX ENABLED
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
    }
)

Template Support

Working with Templates

The PowerPoint MCP Server provides comprehensive template support for creating presentations from existing template files. This feature enables:

• Corporate branding with predefined themes, layouts, and styles
• Consistent presentations across teams and projects
• Custom slide masters and specialized layouts
• Pre-configured properties and document settings
• Flexible template discovery with configurable search paths

Template File Requirements

• Supported formats: .pptx and .potx files
• Existing content: Templates can contain existing slides (preserved during creation)
• Layout availability: All custom layouts and slide masters are accessible
• Search locations: Configurable via PPT_TEMPLATE_PATH environment variable
• Default search paths: Current directory, ./templates, ./assets, ./resources

Template Configuration

Set the PPT_TEMPLATE_PATH environment variable to specify 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"

Template Workflow

1. Inspect Template: Use get_template_info to analyze available layouts and properties
2. Create from Template: Use create_presentation_from_template with automatic theme preservation
3. Use Template Layouts: Reference layout indices from template analysis when adding slides
4. Maintain Branding: Template themes, fonts, and colors are automatically applied to new content

Professional Color Schemes

The server includes 4 built-in professional color schemes:

• Modern Blue: Microsoft-inspired blue theme with complementary colors
• Corporate Gray: Professional grayscale theme with blue accents
• Elegant Green: Forest green theme with cream and light green accents
• Warm Red: Deep red theme with orange and yellow accents

Each scheme includes primary, secondary, accent, light, and text colors optimized for business presentations.

🎨 Built-in Slide Templates (New in v2.0)

The PowerPoint MCP Server now includes 25 professional slide templates with advanced dynamic features. All templates support:

Dynamic Features

• 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

Available Template Categories

Title & Introduction Slides

• title_slide - Dynamic title slide with gradient background and text effects
• chapter_intro - Section divider with chapter numbering and styling
• thank_you_slide - Closing slide with contact information and effects

Content Layout Slides

• text_with_image - Text content with stylized image and interactive elements
• two_column_text - Two equal columns of text with dynamic sizing
• two_column_text_images - Two columns with text and corresponding images
• three_column_layout - Three equal columns with text and images
• full_image_slide - Large background image with text overlay

Business & Analytics Slides

• key_metrics_dashboard - Interactive metrics dashboard with animated counters
• before_after_comparison - Dynamic comparison layout with visual dividers
• chart_comparison - Two charts side by side for performance comparison
• data_table_slide - Slide focused on tabular data with professional styling
• timeline_slide - Horizontal timeline with milestones and effects

Process & Flow Slides

• process_flow - Step-by-step process visualization with enhanced effects
• agenda_slide - Table of contents or agenda overview with styling
• quote_testimonial - Featured quote or customer testimonial with effects

Team & Organization Slides

• team_introduction - Team member showcase with photos and roles

Template Usage Examples

# Browse all available templates
templates = use_mcp_tool("ppt", "list_slide_templates", {})

# Key templates with their features:
{
  "title_slide": {
    "features": ["Dynamic text sizing", "Gradient backgrounds", "Text effects"],
    "elements": ["title", "subtitle", "author", "decorative_accent"]
  },
  "key_metrics_dashboard": {
    "features": ["Animated counters", "Gradient containers", "Trend visualization"],
    "elements": ["3 metric containers", "trend chart", "insights callout"]
  },
  "before_after_comparison": {
    "features": ["Split gradient background", "VS divider", "Improvement arrow"],
    "elements": ["before/after headers", "comparison content", "improvement metrics"]
  }
}

Color Scheme Integration

All templates work seamlessly with the 4 professional color schemes:

• 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

Dynamic Content Adaptation

Templates automatically adjust to content:

• Font sizes scale based on text length (8pt - 44pt range)
• Line spacing adjusts for readability (1.0x - 1.4x)
• Text wrapping intelligently breaks lines at optimal points
• Container sizing adapts to content overflow
• Visual effects scale appropriately with element sizes

📁 File Structure

Office-PowerPoint-MCP-Server/
├── ppt_mcp_server.py          # Main consolidated server (v2.0)
├── slide_layout_templates.json # 25+ professional slide templates with dynamic features
├── tools/                     # 11 specialized tool modules (32 tools total)
│   ├── __init__.py
│   ├── presentation_tools.py  # Presentation management (7 tools)
│   ├── content_tools.py       # Content & slides (6 tools)
│   ├── template_tools.py      # Template operations (7 tools)
│   ├── structural_tools.py    # Tables, shapes, charts (4 tools)
│   ├── professional_tools.py  # Themes, effects, fonts (3 tools)
│   ├── hyperlink_tools.py     # Hyperlink management (1 tool)
│   ├── chart_tools.py         # Advanced chart operations (1 tool)
│   ├── connector_tools.py     # Connector lines/arrows (1 tool)
│   ├── master_tools.py        # Slide master management (1 tool)
│   └── transition_tools.py    # Slide transitions (1 tool)
├── utils/                     # 7 organized utility modules (68+ functions)
│   ├── __init__.py
│   ├── core_utils.py          # Error handling & safe operations
│   ├── presentation_utils.py  # Presentation management utilities
│   ├── content_utils.py       # Content & slide operations
│   ├── design_utils.py        # Themes, colors, effects & fonts
│   ├── template_utils.py      # Template management & dynamic features
│   └── validation_utils.py    # Text & layout validation
├── setup_mcp.py              # Interactive setup script
├── pyproject.toml            # Updated for v2.0
└── README.md                 # This documentation

🏗️ Architecture Benefits

Modular Design

• 7 focused utility modules with clear responsibilities
• 11 organized tool modules for comprehensive coverage
• 68+ utility functions organized by functionality
• 32 MCP tools covering all PowerPoint manipulation needs
• Clear separation of concerns for easier development

Code Organization

• Logical grouping of related functionality across modules
• Better discoverability with organized tool categories
• Improved testability with isolated modules
• Future extensibility through modular structure

Comprehensive Coverage

• Complete PowerPoint lifecycle from creation to presentation
• Advanced template system with auto-generation capabilities
• Professional design tools with multiple effects and styling options
• Specialized features including hyperlinks, connectors, and slide masters

Developer Experience

• Clear responsibility boundaries between modules
• Easier debugging with smaller, focused files
• Simpler testing with isolated functionality
• Enhanced maintainability through separation of concerns

🔄 What's New in Version 2.0

Enhanced functionality with comprehensive tool coverage! The updated server provides:

New Specialized Tools Added:

• manage_hyperlinks - Complete hyperlink management for text elements
• update_chart_data - Advanced chart data replacement and updating
• add_connector - Connector lines and arrows between slide elements
• manage_slide_masters - Access to slide master properties and layouts
• manage_slide_transitions - Basic slide transition management
• auto_generate_presentation - AI-powered presentation generation
• optimize_slide_text - Text optimization for better readability

Enhanced Existing Tools:

• manage_text - Now supports text run formatting with format_runs operation
• create_presentation_from_templates - Enhanced template sequence processing
• apply_picture_effects - Expanded effect combinations and options

License

MIT