Skip to main content
Glama

šŸ“Š PPTX MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to create, edit, and manipulate PowerPoint presentations programmatically.

✨ Features

  • Full PowerPoint Control - Create, read, and modify .pptx files without needing PowerPoint installed

  • AI-Native Design - Built specifically for LLMs to generate and edit presentations through structured JSON

  • Rich Formatting Support - Text styling, colors, alignment, bullets, shapes, and backgrounds

  • Template Workflows - Extract content from existing presentations, modify, and regenerate

  • Visual Debugging - Generate thumbnail grids to preview slides programmatically

  • Office XML Access - Direct access to underlying OOXML for advanced customization

Related MCP server: mcp-powerpoint

šŸš€ Quick Start

1. Install

# Clone the repository
git clone https://github.com/YOUR_USERNAME/pptx-mcp-server.git
cd pptx-mcp-server

# Install the package
pip install -e .

2. Configure Your MCP Client

Add to your MCP settings:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "pptx": {
      "command": "python",
      "args": ["-m", "pptx_mcp_server"]
    }
  }
}

Add to your MCP configuration:

{
  "mcpServers": {
    "pptx": {
      "command": "python",
      "args": ["-m", "pptx_mcp_server"]
    }
  }
}

Specify the full path to your Python interpreter:

{
  "mcpServers": {
    "pptx": {
      "command": "/path/to/your/python",
      "args": ["-m", "pptx_mcp_server"]
    }
  }
}

Examples:

  • Conda: /Users/username/miniconda3/bin/python

  • venv: /path/to/project/.venv/bin/python

3. Restart Your MCP Client

Restart Claude Desktop, Cursor, or your MCP client to load the server.

šŸ“¦ Requirements

  • Python 3.10+

  • Dependencies (installed automatically):

    • mcp - Model Context Protocol SDK

    • python-pptx - PowerPoint file manipulation

    • Pillow - Image processing

    • lxml - XML parsing

    • defusedxml - Secure XML parsing

Optional (for thumbnails)

# macOS
brew install --cask libreoffice
brew install poppler

# Ubuntu/Debian
sudo apt-get install libreoffice poppler-utils

šŸ› ļø Available Tools

Tool

Description

create_presentation

Create new presentations from scratch

extract_text_inventory

Extract text content with positions and formatting

apply_text_replacements

Replace text using JSON specifications

rearrange_slides

Duplicate, delete, and reorder slides

create_thumbnail_grid

Generate visual thumbnail grids

unpack_office_document

Extract Office files to editable XML

pack_office_document

Rebuild Office files from XML

validate_office_document

Validate document structure

šŸ“– Usage Examples

Create a New Presentation

{
  "output_path": "/path/to/presentation.pptx",
  "layout": "16:9",
  "slides": [
    {
      "background": "#0f172a",
      "shapes": [
        {
          "type": "textbox",
          "left": 0.5,
          "top": 3,
          "width": 12,
          "height": 1.5,
          "text": "Welcome to My Presentation",
          "font_size": 54,
          "bold": true,
          "color": "#ffffff",
          "alignment": "center"
        },
        {
          "type": "textbox",
          "left": 0.5,
          "top": 5,
          "width": 12,
          "height": 1,
          "text": "Subtitle goes here",
          "font_size": 24,
          "color": "#94a3b8",
          "alignment": "center"
        }
      ]
    },
    {
      "shapes": [
        {
          "type": "textbox",
          "left": 0.5,
          "top": 0.5,
          "width": 12,
          "height": 1,
          "text": "Key Points",
          "font_size": 36,
          "bold": true
        },
        {
          "type": "textbox",
          "left": 0.5,
          "top": 1.8,
          "width": 12,
          "height": 5,
          "paragraphs": [
            {"text": "First important point", "font_size": 24, "bullet": true},
            {"text": "Second important point", "font_size": 24, "bullet": true},
            {"text": "Third important point", "font_size": 24, "bullet": true}
          ]
        }
      ]
    }
  ]
}

Supported shape types:

  • textbox - Text content

  • rectangle - Rectangle (can contain text)

  • rounded_rectangle - Rounded corners

  • oval - Circle/ellipse

  • image - Image file (use path property)

  • line - Line connector

Supported layouts: 16:9, 4:3, widescreen, standard

Extract Text Inventory

Get all text content from an existing presentation:

{
  "pptx_path": "/path/to/presentation.pptx"
}

Returns structured JSON:

{
  "slide-0": {
    "shape-0": {
      "left": 0.5,
      "top": 1.0,
      "width": 12.0,
      "height": 1.5,
      "paragraphs": [
        {"text": "Title Text", "font_size": 44.0, "bold": true}
      ]
    }
  }
}

Replace Text Content

Modify text in an existing presentation:

{
  "pptx_path": "/path/to/template.pptx",
  "output_path": "/path/to/output.pptx",
  "replacements_json": {
    "slide-0": {
      "shape-0": [
        {"text": "New Title", "font_size": 44, "bold": true}
      ]
    }
  }
}

Rearrange Slides

Reorder, duplicate, or remove slides:

{
  "template_path": "/path/to/template.pptx",
  "output_path": "/path/to/output.pptx",
  "slide_sequence": "0,2,2,1,3"
}
  • 0,2,2,1,3 → Keep slide 0, duplicate slide 2, then slides 1 and 3

  • Omit an index to delete that slide

Unpack/Pack for XML Editing

// Unpack to directory
{
  "office_file": "/path/to/document.pptx",
  "output_dir": "/path/to/unpacked"
}

// Pack back to file
{
  "input_dir": "/path/to/unpacked",
  "output_file": "/path/to/output.pptx"
}

šŸ”§ Troubleshooting

Ensure you're using the correct Python environment:

# Check which Python pip uses
pip --version

# Install with specific Python
/path/to/python -m pip install -e .
  1. Verify the config file path is correct for your OS

  2. Ensure JSON syntax is valid (no trailing commas)

  3. Restart the MCP client completely

  4. Check logs for errors

Install LibreOffice and poppler:

# macOS
brew install --cask libreoffice && brew install poppler

# Linux
sudo apt-get install libreoffice poppler-utils

Ensure the output paths are writable and parent directories exist.

šŸ“ Project Structure

pptx-mcp-server/
ā”œā”€ā”€ pyproject.toml              # Package configuration
ā”œā”€ā”€ README.md
└── pptx_mcp_server/
    ā”œā”€ā”€ __init__.py
    ā”œā”€ā”€ server.py               # MCP server implementation
    └── tools/
        ā”œā”€ā”€ __init__.py
        ā”œā”€ā”€ create.py           # Create new presentations
        ā”œā”€ā”€ inventory.py        # Extract text content
        ā”œā”€ā”€ replace.py          # Text replacement
        ā”œā”€ā”€ rearrange.py        # Slide manipulation
        ā”œā”€ā”€ thumbnail.py        # Visual thumbnails
        └── ooxml.py            # XML pack/unpack/validate

šŸ¤ Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

šŸ™ Acknowledgments

Available Tools

8 tools
apply_text_replacementsA

Apply text replacements to a PowerPoint presentation using a JSON specification. The JSON should map slide/shape IDs to new paragraph content with formatting. All text shapes are cleared unless explicitly provided with new content.

Inputs: pptx_path (required), replacements_json (required), output_path (required).

create_presentationA

Create a new PowerPoint presentation from scratch. Accepts a JSON specification with slides, shapes, text content, and formatting. Supports text boxes, rectangles, ovals, images, and various text formatting options. Use this to create new presentations before using other tools to modify them.

Inputs: output_path (required), layout, slides.

create_thumbnail_gridA

Create visual thumbnail grids from PowerPoint slides. Useful for quick visual analysis of presentation structure and layouts. For large presentations, multiple grid images are created automatically.

Inputs: pptx_path (required), output_prefix, cols, outline_placeholders.

extract_text_inventoryA

Extract structured text content from a PowerPoint presentation. Returns JSON with all text shapes, their positions, and formatting details. Useful for understanding presentation structure before making replacements.

Inputs: pptx_path (required), output_path, issues_only.

pack_office_documentA

Pack a directory back into an Office document (.docx, .pptx, .xlsx). Removes pretty-printing whitespace from XML before packing. Can optionally validate the document before saving.

Inputs: input_dir (required), output_file (required), validate, force.

rearrange_slidesB

Rearrange slides in a PowerPoint presentation. Can duplicate, delete, and reorder slides based on a sequence of indices. Slide indices are 0-based. The same index can appear multiple times to duplicate.

Inputs: template_path (required), output_path (required), slide_sequence (required).

unpack_office_documentA

Unpack an Office document (.docx, .pptx, .xlsx) to a directory. The XML files are pretty-printed for easy reading and editing. Use this to inspect or manually edit the raw XML structure.

Inputs: office_file (required), output_dir (required).

validate_office_documentA

Validate an unpacked Office document against XSD schemas. Checks XML well-formedness, namespace declarations, unique IDs, file references, content types, and schema compliance. Returns detailed error messages for any issues found.

Inputs: unpacked_dir (required), original_file (required), verbose.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes focused on PowerPoint operations, but there is some overlap between pack_office_document and unpack_office_document with validate_office_document, as all three handle Office document file structures. However, their specific functions (packing, unpacking, validating) are clearly differentiated in descriptions, minimizing confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, such as apply_text_replacements, create_presentation, and extract_text_inventory. This uniformity makes the tool set predictable and easy to navigate for agents.

    Tool Count5/5

    With 8 tools, the server is well-scoped for PowerPoint manipulation, covering creation, modification, extraction, and file handling. Each tool serves a clear purpose without redundancy, fitting the domain effectively.

    Completeness4/5

    The tool set provides comprehensive coverage for PowerPoint operations, including creation, text editing, slide management, and file handling. A minor gap exists in advanced formatting or animation tools, but core workflows are fully supported, allowing agents to perform most common tasks.

    Related MCP Connectors

    Related MCP Servers