Gamma MCP

The Universal MCP Server exposes tools for the Gamma Generations API and is designed for prompt-first workflows in MCP-compatible clients.

Installation

Prerequisites

• Node.js 18+
• Set UNIVERSAL_MCP_SERVER_GAMMA_API_KEY in your environment

Get a Gamma API key

• See Gamma developer docs and request access
  • Overview: https://developers.gamma.app/docs/how-does-the-generations-api-work
  • Access: https://developers.gamma.app/docs/get-access
  • Getting Started: https://developers.gamma.app/docs/getting-started

Build locally

cd /Users/kimurataiyou/gamma-mcp
npm i
npm run build

Setup: Claude Code (CLI)

Use this one-line command (replace with your real API key):

claude mcp add Gamma-MCP -s user -e GAMMA_MCP_GAMMA_API_KEY="sk-your-real-key" -- npx gamma-mcp

To remove the server from Claude Code:

claude mcp remove Gamma-MCP

Setup: Cursor

Create .cursor/mcp.json at your repository root:

{
  "mcpServers": {
    "gamma-mcp": {
      "command": "npx",
      "args": ["gamma-mcp"],
      "env": { "GAMMA_MCP_GAMMA_API_KEY": "sk-your-real-key" },
      "autoStart": true
    }
  }
}

Other Clients and Agents

Configuration (Env)

• GAMMA_MCP_GAMMA_API_KEY: Your Gamma API key (required)
• GAMMA_MCP_GAMMA_BASE_URL: Base URL override (default: https://generations.gamma.app)
• GAMMA_API_KEY / GAMMA_BASE_URL: Legacy fallbacks
• MCP_NAME: Server name override (default: gamma-mcp)

Available Tools

• gamma_create_generation
  • inputs:
    • inputText?: string
    • textMode?: “generate” | “condense” | “preserve”
    • format?: “presentation” | “document” | “social”
    • themeName?: string
    • numCards?: number
    • cardSplit?: “auto” | “inputTextBreaks”
    • additionalInstructions?: string
    • exportAs?: “pdf” | “pptx”
    • textOptions?: { amount?: “brief” | “medium” | “detailed” | “extensive”, tone?: string, audience?: string, language?: string }
    • imageOptions?: { source?: “aiGenerated” | “pictographic” | “unsplash” | “giphy” | “webAllImages” | “webFreeToUse” | “webFreeToUseCommercially” | “placeholder” | “noImages”, model?: string, style?: string }
    • cardOptions?: { dimensions?: string }
    • sharingOptions?: { workspaceAccess?: “noAccess” | “view” | “comment” | “edit” | “fullAccess”, externalAccess?: “noAccess” | “view” | “comment” | “edit” }
• gamma_get_generation
  • inputs:
    • generationId: string
    • expand?: boolean
• gamma_list_generations
  • inputs:
    • status?: string (queued|processing|ready|failed)
    • limit?: number
    • page?: number
• gamma_get_asset
  • inputs:
    • generationId: string
    • assetId: string

Example invocation (MCP tool call)

{
  "name": "gamma_create_generation",
  "arguments": {
    "inputText": "AIエージェントについて、技術者向けに12枚のスライドで解説してください。",
    "format": "presentation",
    "numCards": 12,
    "textOptions": {
      "language": "ja",
      "tone": "professional",
      "audience": "技術者・研究者",
      "amount": "medium"
    }
  }
}

Troubleshooting

• 401 auth errors: verify UNIVERSAL_MCP_SERVER_GAMMA_API_KEY
• Ensure Node 18+
• If running via npx locally: npx universal-mcp-server works after npm run build
• For local development: you can run node build/index.js directly

References

• Gamma Generations API Overview: https://developers.gamma.app/docs/how-does-the-generations-api-work
• Gamma Access: https://developers.gamma.app/docs/get-access
• Gamma Getting Started: https://developers.gamma.app/docs/getting-started
• Model Context Protocol Quickstart: https://modelcontextprotocol.io/quickstart/server
• MCP SDK Docs: https://modelcontextprotocol.io/docs/sdk
• MCP Architecture: https://modelcontextprotocol.io/docs/learn/architecture

Name Consistency & Troubleshooting

• Always use CANONICAL_ID (gamma-mcp) for identifiers and configuration keys.
• Use CANONICAL_DISPLAY (Gamma MCP) only for UI labels or documentation prose.
• Do not mix legacy names once you have added the server to a client registry.

Consistency Matrix:

• npm package name → gamma-mcp
• Binary name → gamma-mcp
• MCP server name (SDK metadata) → gamma-mcp
• Env default MCP_NAME → gamma-mcp
• Client registry key → gamma-mcp
• UI label → Gamma MCP

Conflict Cleanup:

• Remove any stale entries such as "UniversalServer" and re-register with "gamma-mcp".
• Ensure global .mcp.json or client registries only contain the canonical identifier.
• Cursor: configure keys in the UI; this project intentionally omits .cursor/mcp.json.

Example:

• Correct: "mcpServers": { "gamma-mcp": { "command": "npx", "args": ["gamma-mcp"] } }
• Incorrect: "UniversalServer" as the key (conflicts with "gamma-mcp").