🎨 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

| Capability | Detail | |---|---| | 13 slide layouts | title, section, two-column, icon trio, stat callout, bullet, quote, timeline, comparison, chart, full image, text body, thank you | | 6 brand themes | Midnight Executive, Coral Energy, Forest Calm, Teal Trust, Charcoal Minimal, Berry & Cream | | Chart types | Bar, Column, Line, Area, Pie, Doughnut | | Design rules baked in | No AI-looking stripe accents, no cream defaults, safe font stack, shadow cards, proper contrast | | Transports | stdio (Claude Desktop / local) and SSE (hosted/remote) |

---

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

| ID | Name | Vibe | |---|---|---| | midnight_executive | Midnight Executive | Navy + ice blue — professional, authoritative | | coral_energy | Coral Energy | Coral + gold — bold, startup-friendly | | forest_calm | Forest Calm | Green + moss — sustainability, wellness | | teal_trust | Teal Trust | Teal + seafoam — fintech, SaaS, healthcare | | charcoal_minimal | Charcoal Minimal | Charcoal + off-white — luxury, editorial | | berry_cream | Berry & Cream | Berry + cream — fashion, lifestyle |

---

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.

pptx-mcp-server