🎨 PPTX MCP Server

A Model Context Protocol (MCP) server that lets any AI model create standardised, high-quality PowerPoint presentations via a clean JSON API.

Plug it in once — every AI that connects gets the same consistent, on-brand slide quality every time, with zero design knowledge required.

Features

Quick Start

1. Install dependencies

# Python
pip install mcp

# Node (pptxgenjs is the rendering engine)
npm install -g pptxgenjs

2. Run the server (stdio)

python pptx_mcp_server.py

3. Run as HTTP/SSE server

python pptx_mcp_server.py --transport sse --port 8000

Claude Desktop Config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pptx-maker": {
      "command": "python",
      "args": ["/absolute/path/to/pptx_mcp_server.py"]
    }
  }
}

Tools

list_themes()

Returns all brand themes with colour swatches and font choices.

list_slide_layouts()

Returns all 13 supported layout types with descriptions.

preview_theme(theme_id)

Returns the full colour/font spec for a theme (useful for AI to reference).

create_presentation(spec)

The main tool. Accepts a JSON spec, generates a .pptx in ./output/.

Spec Schema

{
  "title":    "My Deck",
  "author":   "Arbaz",
  "subject":  "Product Pitch",
  "theme_id": "midnight_executive",
  "filename": "my_deck.pptx",
  "slides": [ ...slide objects... ]
}

Slide objects by layout

#### title_slide

{ "layout": "title_slide", "title": "...", "subtitle": "...", "tagline": "..." }

#### section_divider

{ "layout": "section_divider", "number": "01", "title": "...", "caption": "..." }

#### two_column

{
  "layout": "two_column",
  "title": "...",
  "left_heading": "...", "left_body": "...",
  "right_heading": "...", "right_body": "..."
}

#### icon_trio

{
  "layout": "icon_trio",
  "title": "...",
  "items": [
    {"heading": "...", "body": "..."},
    {"heading": "...", "body": "..."},
    {"heading": "...", "body": "..."}
  ]
}

#### stat_callout

{
  "layout": "stat_callout",
  "title": "...",
  "stats": [
    {"value": "94%", "label": "Customer Satisfaction", "delta": "+12% YoY"},
    {"value": "£2.4M", "label": "Revenue", "delta": ""}
  ]
}

#### bullet_list

{ "layout": "bullet_list", "title": "...", "bullets": ["Point 1", "Point 2"] }

#### quote_highlight

{ "layout": "quote_highlight", "quote": "...", "attribution": "— Name, Role" }

#### timeline

{
  "layout": "timeline",
  "title": "...",
  "steps": [
    {"label": "Phase 1", "text": "Discovery"},
    {"label": "Phase 2", "text": "Build"}
  ]
}

#### comparison

{
  "layout": "comparison",
  "title": "...",
  "left_heading": "Option A", "left_points": ["Pro 1", "Pro 2"],
  "right_heading": "Option B", "right_points": ["Pro 1", "Pro 2"]
}

#### chart_slide

{
  "layout": "chart_slide",
  "title": "...",
  "caption": "Source: ...",
  "chart_type": "bar",
  "chart_data": {
    "series_name": "Revenue",
    "labels": ["Q1", "Q2", "Q3", "Q4"],
    "values": [120, 145, 162, 198]
  }
}

Supported chart_type values: bar, line, pie, doughnut, area

#### image_full

{ "layout": "image_full", "title": "...", "caption": "...", "image_url": "https://..." }

#### text_body

{ "layout": "text_body", "title": "...", "body": "...", "note": "Optional footnote" }

#### thank_you

{ "layout": "thank_you", "message": "Thank You", "contact": "...", "website": "..." }

Available Themes

Design Principles (enforced automatically)

• No decorative stripe accents (AI-generated tell)
• No cream/beige defaults
• No accent underlines under titles
• Cards use shadow + tint, never edge borders
• Safe font stack (Calibri, Cambria, Bookman Old Style)
• Minimum 0.5" margins throughout
• Every layout has a visual element — no text-only slides

Output

Files are saved to ./output/<filename>.pptx relative to the server directory.