powerpoint-mcp

PowerPoint MCP

An MCP server that lets AI assistants manipulate live, open PowerPoint presentations on macOS and PowerPoint Web via Office.js APIs.

Unlike file-based tools (python-pptx), PowerPoint MCP works with presentations that are already open — changes appear instantly, and you keep full access to PowerPoint's UI, animations, and formatting.

Installation

Codex Plugin

This repository includes Codex plugin metadata in .codex-plugin/ and Codex repo instructions in AGENTS.md.

For local development:

git clone https://github.com/kzarzycki/powerpoint-mcp.git
cd powerpoint-mcp
npm install
npm run build

The Codex plugin MCP config in .mcp.json uses the shared HTTP MCP endpoint:

{
  "mcpServers": {
    "powerpoint-mcp": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

The Codex plugin ships a SessionStart hook in hooks/hooks.json. On session start it runs scripts/start-http-bridge.sh, which starts the built bridge with node ./dist/index.cjs --http --bridge if the HTTP MCP server or add-in bridge is not already healthy.

Then restart PowerPoint, open a presentation, and click the bridge add-in in the ribbon. For manual local development, start the TypeScript source directly with node --experimental-strip-types ./server/index.ts --http --bridge.

Claude Code Plugin (recommended)

Zero-config install from the marketplace. MCP auto-starts, add-in auto-sideloads, skill included.

/plugin marketplace add kzarzycki/powerpoint-mcp
/plugin install powerpoint-mcp@powerpoint-mcp

Then restart PowerPoint, open a presentation, and click the bridge add-in in the ribbon.

Claude Desktop Extension

Build and install as a one-click .mcpb extension (from source):

git clone https://github.com/kzarzycki/powerpoint-mcp.git
cd powerpoint-mcp
npm install && npm run build:mcpb
open powerpoint-mcp-*.mcpb   # opens Claude Desktop installer

The extension auto-starts the bridge and auto-sideloads the add-in. Restart PowerPoint after first install.

Known limitations:

• Chat mode only — Cowork and Code tabs don't load desktop extensions (upstream bug)
• Single instance — only one bridge can run on port 8080

From source (development)

git clone https://github.com/kzarzycki/powerpoint-mcp.git
cd powerpoint-mcp
npm install
npm run sideload              # copies manifest to PowerPoint's add-in folder
npm start -- --http --bridge  # starts the MCP HTTP transport (:3001/mcp) + add-in bridge (:8080)

Then point your MCP client at the HTTP transport. Create or merge into the project's .mcp.json:

{
  "mcpServers": {
    "powerpoint-mcp": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

Restart PowerPoint, open a presentation, and click the bridge add-in in the ribbon. For STDIO mode and other standalone options, see skills/powerpoint-mcp/references/setup.md.

Motivation

This project was inspired by the Claude in PowerPoint add-in. The first time I tried it, I was amazed — it edits live, open decks via Office.js, and the results are far better than file-based pptx tools. But it only works inside the add-in, which means no access to CLAUDE.md, skills, or any other Claude Code features. PowerPoint MCP brings those same Office.js capabilities to Claude Code (and any MCP client) so you get live editing with the full power of your coding environment.

The project was originally named powerpoint-bridge and renamed to powerpoint-mcp in v0.5.0. The "bridge server" component keeps its name — it bridges MCP and the Office.js add-in over WebSocket.

Architecture

AI Assistant  <--MCP STDIO/HTTP-->  Bridge Server (Node.js)  <--WS/WSS-->  PowerPoint Add-in (Office.js)
                                           |                                       |
                                     STDIO (default)                      Desktop: WKWebView sandbox
                                     or HTTP (:3001/mcp)                  Web: browser iframe
                                     localhost:8080 (HTTP)                Office.js API 1.1-1.8
                                     or :8443 (HTTPS)                    executes commands on
                                     serves add-in files + WS             live presentation