Gamma MCP Server

Gamma FastMCP Server

This is a Python FastAPI + FastMCP server that wraps the Gamma APIs and exposes an MCP HTTP endpoint that MCP Clients can connect to.

What this server provides

• MCP tools:
  • generate_presentation
  • create_from_template
  • get_generation_status
  • list_themes
  • list_folders
• Health endpoint: /health
• MCP transport: streamable-http (default)
• No OAuth flow required for MCP Client (server uses GAMMA_API_KEY from env)
• Tool definitions live in lib/tool.py and are registered from main.py

It uses Gamma's current flows:

1. POST /v1.0/generations to create a generation job
2. POST /v1.0/generations/from-template for template-based creation
3. Poll GET /v1.0/generations/{generationId} until status is completed
4. Use GET /v1.0/themes and GET /v1.0/folders with pagination when needed

Reference: Gamma Generate API parameters explained

1) Setup (uv)

From gamma-mcp/:

uv sync

Create .env from .env.example and set your key:

GAMMA_API_KEY=sk-gamma-...
PORT=8000
MCP_TRANSPORT=streamable-http

2) Run server

uv run python main.py

Server will start on:

• http://localhost:8000/mcp (MCP endpoint for MCP Client)
• http://localhost:8000/health (health check)

3) Add in MCP Client connector UI

In MCP Client Add Connector -> Add MCP Server:

• Name: Gamma MCP
• URL: http://localhost:8000/mcp
• Transport: http
• Auth headers: leave empty (Gamma key is handled server-side via env)

Then click Discover Tools, select generate_presentation, and save.

4) Example prompt in MCP Client

"Use Gamma MCP to generate a 10-card presentation on AI agents for product teams."