Gamma MCP Server
A Model Context Protocol (MCP) server for Gamma AI that provides tools and resources for generating presentations, documents, and webpages using the Gamma Public API.
Features
Resources (2)
gamma://folders- List all folders (channels) in your Gamma workspacegamma://themes- List all available themes for generation
Tools (1)
generate_gamma- Generate Gamma content with AI, including automatic polling until completion
Prerequisites
Node.js 18+
Yarn package manager
A Gamma API key (get one here)
Installation
Install dependencies:
yarn installConfigure your API key:
Edit
src/gamma-api.service.tsand replace the placeholder API key:const GAMMA_API_KEY = 'sk-gamma-your-api-key-here';Replace
'sk-gamma-your-api-key-here'with your actual Gamma API key.Build the project:
yarn build
Running the Server
Development mode (with auto-reload):
Production mode:
The server will start on http://localhost:3000 using streamable HTTP transport.
Connecting to Claude Desktop
To use this MCP server with Claude Desktop, add it to your Claude configuration:
macOS/Linux:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
Windows:
Edit %APPDATA%\Claude\claude_desktop_config.json with similar configuration.
Important: Replace /absolute/path/to/gamma-mcp-server with the actual absolute path to this project directory.
Usage Examples
Once connected to Claude Desktop, you can use natural language to interact with Gamma:
List Available Themes
List Workspace Folders
Generate a Presentation
Generate with Export
API Reference
Resources
gamma://folders
Returns all workspace folders with pagination automatically handled.
Response:
gamma://themes
Returns all available themes with pagination automatically handled.
Response:
Tools
generate_gamma
Generate Gamma content with automatic polling until completion.
Parameters:
inputText(required): Content to generate from (max 400k chars)textMode(required):"generate","condense", or"preserve"format(optional):"presentation","document","social", or"webpage"(default: "presentation")numCards(optional): Number of cards/pages to generatethemeId(optional): Theme ID from the themes resourcefolderIds(optional): Array of folder IDs to save the gamma inexportAs(optional):"pptx"or"pdf"to generate an export URL
Returns:
Development
Project Structure
Scripts
yarn build- Compile TypeScript to JavaScriptyarn start- Run the compiled serveryarn dev- Run in development mode with ts-nodeyarn watch- Watch mode for TypeScript compilation
Troubleshooting
"Invalid API key" error
Make sure you've replaced the placeholder API key in src/gamma-api.service.ts with your actual Gamma API key.
Server won't start
Make sure you've run
yarn installandyarn buildCheck that port 3000 is not already in use
Check the console for error messages
Claude Desktop can't connect
Verify the absolute path in your Claude config is correct
Make sure the server is built (
yarn build)Restart Claude Desktop after editing the config
Check Claude Desktop logs for connection errors
Learn More
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI-powered generation of presentations, documents, and webpages through the Gamma API. Supports theme selection, folder management, and automatic export to PowerPoint or PDF formats.