Gamma MCP Server

This document guides you through setting up and running the Gamma MCP (Model Context Protocol) server, which allows you to generate presentations using the Gamma API directly from MCP clients like Anthropic's Claude for Desktop.

What is Gamma?

Gamma is an AI-powered platform designed to help users create various types of content, with a strong focus on presentations. It leverages artificial intelligence to automatically generate slides, suggest text, and incorporate imagery, allowing for rapid development of polished presentations from simple prompts or existing documents. This MCP server specifically interacts with Gamma's API to bring this presentation generation capability into environments like Claude for Desktop. Check out the Gamma API docs to learn more.

What We'll Be Building

This server exposes a tool to an MCP client (like Claude for Desktop) that can take a prompt and various parameters to generate a presentation using the Gamma API. The server will return a link to the generated presentation.

Core MCP Concepts

Model Context Protocol servers can provide three main types of capabilities:

• Resources: File-like data that can be read by clients (like API responses or file contents).
• Tools: Functions that can be called by the LLM (with user approval).
• Prompts: Pre-written templates that help users accomplish specific tasks.

This server primarily focuses on providing a Tool.

Prerequisite Knowledge

This quickstart assumes you have familiarity with:

• Node.js and TypeScript.
• LLMs like Anthropic's Claude.
• Basic command-line usage.

System Requirements

• Node.js (v16 or higher recommended).
• npm (Node Package Manager) or yarn.
• Access to the Gamma API. You'll need an API key, don't have one? Check out the Gamma API docs to get one.

Set Up Your Environment

1. Clone the Repository / Get the Code: If this project is in a Git repository, clone it:

   git clone git@github.com:gamma-app/gamma-mcp-server.git
   cd gamma-mcp-server
   

2. Initialize Your Node.js Project (if not cloned): If you created a new directory, initialize a package.json file:

   npm init -y
   

3. Install Dependencies: You'll need the MCP SDK, Zod for validation, node-fetch for API calls, TypeScript, and ts-node to run TypeScript directly.

   npm install @modelcontextprotocol/sdk zod node-fetch typescript ts-node @types/node
   # or
   # yarn add @modelcontextprotocol/sdk zod node-fetch typescript ts-node @types/node
   

4. Configure TypeScript: You might want to adjust the tsconfig.json to suit your preferences, but the default should work. Ensure moduleResolution is set to "node" or "node16" / "nodenext" and module is compatible (e.g. "commonjs" if running with ts-node in a CommonJS context, or adjust for ES Modules). The provided src/index.ts uses ES module syntax (import ... from). A common tsconfig.json for ES Modules with Node.js might include:

   {
     "compilerOptions": {
       "target": "ES2020",
       "module": "ESNext",
       "moduleResolution": "node",
       "esModuleInterop": true,
       "forceConsistentCasingInFileNames": true,
       "strict": true,
       "skipLibCheck": true,
       "outDir": "./dist" // Optional: if you plan to compile
     },
     "include": ["src/**/*"],
     "exclude": ["node_modules"]
   }
   

   Also, in your package.json, add "type": "module" if you are using ES Modules.

5. API Key Configuration: The server requires your Gamma API key. We use the dotenv package to load this key from a .env file in the project root.

   1. Create a file named .env in the root of your project (e.g., alongside your package.json).
   2. Add your Gamma API key to this file like so:

... View full README on GitHub