gamma-mcp-server
Enables GitHub Copilot to generate Gamma content such as presentations and documents from code or prompts.
Integrates with Google Gemini to create presentations, documents, webpages, and social posts via Gamma.
Allows OpenAI Codex assistants to generate Gamma presentations, documents, webpages, and social posts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gamma-mcp-server Create a presentation about the benefits of remote work"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gamma MCP Server
A Model Context Protocol (MCP) server that integrates Gamma.app with AI assistants. Create presentations, documents, webpages, and social posts directly from your AI conversations.
Works with: Claude Code, Claude Desktop, OpenCode, GitHub Copilot CLI, Google Gemini CLI, and any other MCP-compatible AI assistant.
Features
Generate Content: Create professional presentations, documents, webpages, and social posts from text prompts
Theme Support: Browse and apply visual themes to your content
Folder Organization: Save generated content to specific folders
Template Remix: Create variations of existing Gamma templates
Email Sharing: Share generated content directly via email
Related MCP server: Gamma MCP Server
Quick Start
1. Clone and Install
git clone https://github.com/Arkava-AI/gamma-mcp-server.git
cd gamma-mcp-server
npm install
npm run build2. Get Your Gamma API Key
Log in to gamma.app
Go to Settings > API (or Settings > Members > API tab)
Click Create API key
Copy the key (format:
sk-gamma-xxxxxxxx)
Note: Requires Gamma Pro, Ultra, Team, or Business account.
3. Configure Your AI Assistant
Choose your AI assistant below for setup instructions.
Claude Desktop (macOS / Windows / Linux)
Config File
OS | Path |
macOS |
|
Linux |
|
Windows |
|
Add to the mcpServers object:
{
"mcpServers": {
"gamma": {
"command": "node",
"args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
"env": {
"GAMMA_API_KEY": "sk-gamma-your-api-key-here"
}
}
}
}Restart Claude Desktop
Restart Claude Desktop to load the new MCP server. You should see "gamma" in your MCP servers list.
Claude Code
Claude Code uses the same MCP configuration as Claude Desktop. If you've already configured Claude Desktop, you're all set.
For project-level configuration, create a .claude/settings.json file in your project directory with the same mcpServers structure shown above. This allows different projects to use different MCP server configurations.
OpenCode
Config File
Scope | Path |
Global (user) |
|
Project |
|
JSON Structure
{
"mcp": {
"gamma": {
"type": "local",
"command": ["node", "/absolute/path/to/gamma-mcp-server/dist/index.js"],
"enabled": true,
"environment": {
"GAMMA_API_KEY": "sk-gamma-your-api-key-here"
}
}
}
}Note: OpenCode uses a different config format from Claude Desktop —
mcp(notmcpServers),typefield required ("local"or"remote"),commandis an array, and env vars go underenvironment.
Restart OpenCode after editing the config to load the server.
GitHub Copilot CLI
Config File
~/.copilot/mcp-config.json
JSON Structure
{
"mcpServers": {
"gamma": {
"type": "local",
"command": "node",
"args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
"env": {
"GAMMA_API_KEY": "sk-gamma-your-api-key-here"
},
"tools": ["*"]
}
}
}Note: Requires the GitHub Copilot CLI (
gh copilot) — not the same as OpenAI Codex.
OpenAI Codex
Config File
~/.codex/config.toml(TOML format, not JSON)
TOML Structure
[mcp_servers.gamma]
command = "node"
args = ["/absolute/path/to/gamma-mcp-server/dist/index.js"]
enabled = true
[mcp_servers.gamma.env]
GAMMA_API_KEY = "sk-gamma-your-api-key-here"Note: Codex uses TOML format, not JSON. The
envsection is a separate table under[mcp_servers.gamma.env].
Google Gemini CLI
Config File
Scope | Path |
User |
|
Project |
|
JSON Structure
{
"mcpServers": {
"gamma": {
"command": "node",
"args": ["/absolute/path/to/gamma-mcp-server/dist/index.js"],
"cwd": "/absolute/path/to/gamma-mcp-server",
"env": {
"GAMMA_API_KEY": "sk-gamma-your-api-key-here"
},
"timeout": 30000
}
}
}Restart Gemini CLI after editing the config to load the server.
Available Tools
Tool | Description |
| Create presentations, documents, webpages, or social posts |
| Check generation progress (with optional polling) |
| Remix existing Gamma templates |
| Browse available visual themes |
| List your Gamma folders |
| Share content via email |
| Verify server and API are reachable |
| Archive a Gamma from your workspace |
gamma_generate
Create new content using Gamma's AI.
Formats & Sizes:
presentation: fluid, 16x9, 4x3document: fluid, pageless, letter, a4social: 1x1, 4x5, 9x16webpage: fluid
Example prompts in your AI assistant:
"Create a 5-slide presentation about sustainable energy"
"Generate a document explaining our Q1 results"
"Make a social media post announcing our new product"
gamma_get_status
Check if a generation has completed. Set waitForCompletion: true to automatically poll until done.
gamma_from_template
Remix an existing Gamma with new content or variable substitutions.
{
"templateId": "gamma_xyz789",
"prompt": "Update for Q1 2025",
"variables": { "company_name": "Acme Corp" }
}Multi-Machine Setup
This repository is designed for easy deployment across multiple machines:
# On each machine:
git clone https://github.com/Arkava-AI/gamma-mcp-server.git
cd gamma-mcp-server
npm install && npm run build
# Then configure your AI assistant with the local pathTo update on any machine:
git pull
npm install
npm run build
# Restart your AI assistantEnvironment Variables
Variable | Default | Description |
| (required) | Your Gamma API key ( |
|
| Override for self-hosted Gamma instances |
|
| Milliseconds between status polls (default 2s) |
|
| Max polling attempts before timeout (default 150 × 2s = 5 min) |
Development
# Run in development mode with auto-reload
npm run dev
# Build for production
npm run build
# Run linting
npm run lint
# Format code
npm run format
# Type check
npm run typecheck
# Test with MCP Inspector
npm run inspectProject Structure
gamma-mcp-server/
├── src/
│ ├── index.ts # Main entry point
│ ├── constants.ts # Configuration constants
│ ├── types.ts # TypeScript interfaces
│ ├── schemas/ # Zod validation schemas
│ ├── services/ # API client and formatters
│ └── tools/ # MCP tool implementations
├── dist/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── eslint.config.jsAPI Credits
Gamma uses a credit-based system for API usage. Credits are consumed per generation. Monitor your usage in the Gamma dashboard and enable auto-recharge if needed.
Troubleshooting
Error | Solution |
"GAMMA_API_KEY environment variable is required" | Ensure |
"Invalid API key" | Keys should start with |
"Rate limit exceeded" | Wait a few minutes. Contact Gamma support for higher limits. |
"Insufficient credits" | Top up credits or enable auto-recharge in Gamma settings. |
Requirements
Node.js 18+
Gamma Pro/Ultra/Team/Business account (for API access)
MCP-compatible AI assistant (Claude Code, Claude Desktop, OpenCode, GitHub Copilot CLI, Gemini CLI, etc.)
Maintainer
Arkava Ltd — engage@arkava.ai
License
MIT License - see LICENSE for details.
Links
Available Tools
8 toolsgamma_archiveArchive GammaADestructiveIdempotent
Archive a Gamma (presentation, document, webpage, or social post) from your workspace.
Archived content is removed from your active workspace but retained for recovery. Use this to declutter your Gamma dashboard.
Inputs: gammaId (required), response_format.
gamma_from_templateCreate from TemplateA
Create new content by remixing an existing Gamma template.
This tool uses Gamma's Remix feature to create a new version of existing content with customizations. Useful for creating variations of proven templates.
PARAMETERS:
templateId (required): ID of the existing Gamma to use as template
prompt: Additional instructions for customization
variables: Key-value pairs for dynamic content substitution
folderId: Folder to save the result
waitForCompletion: If true, waits for completion
RETURNS: Same as gamma_generate
EXAMPLE: { templateId: "gamma_xyz789", prompt: "Update for Q1 2025 results", variables: { "company_name": "Acme Corp", "quarter": "Q1 2025" } }
Inputs: templateId (required), prompt, folderId, variables, +2 more.
gamma_generateGenerate Gamma ContentA
Create a new presentation, document, webpage, or social post using Gamma's AI.
This tool generates professional content from any text input - a one-line prompt, messy notes, or polished content. Gamma's AI will structure, design, and style your content automatically.
SUPPORTED FORMATS:
presentation: Slide decks (sizes: fluid, 16x9, 4x3)
document: Reports, articles, essays (sizes: fluid, pageless, letter, a4)
webpage: Websites with header/footer support (size: fluid)
social: Social media posts (sizes: 1x1, 4x5, 9x16)
PARAMETERS:
prompt (required): Your content or instructions. Can be brief ("Company overview presentation") or detailed with bullet points.
format (required): One of presentation, document, webpage, social
cards: Number of slides/sections (1-60, default: AI-determined)
size: Aspect ratio appropriate for the format
themeId: Visual theme ID (use gamma_list_themes to see options)
language: Target language code (en, es, fr, de, zh, ja, etc.)
imageStyle: auto, photographic, generated, clipart, none
cardDensity: auto, high, low
waitForCompletion: If true, waits up to 5 min for generation to complete
RETURNS:
generationId: ID for tracking/status checks
status: pending, completed, or failed
url: Link to view content (when completed)
title: Generated or custom title
EXAMPLES:
Quick presentation: { prompt: "5 slide pitch deck for AI startup", format: "presentation" }
Detailed document: { prompt: "Technical documentation for REST API...", format: "document", cards: 10 }
Styled content: { prompt: "Company culture overview", format: "presentation", themeId: "theme_123", waitForCompletion: true }
CREDITS: Each generation consumes Gamma API credits based on complexity.
Inputs: no named parameters.
gamma_get_statusGet Generation StatusARead-onlyIdempotent
Check the status of a Gamma generation.
Use this tool to check if a previously started generation has completed. Generations typically take 30 seconds to 2 minutes depending on complexity.
PARAMETERS:
generationId (required): The ID returned from gamma_generate
waitForCompletion: If true, polls until complete (max 5 minutes)
RETURNS:
status: pending, completed, or failed
url: Link to view content (when completed)
title: Content title
creditsUsed: Credits consumed
EXAMPLE: { generationId: "gen_abc123", waitForCompletion: true }
Inputs: generationId (required), response_format, waitForCompletion.
gamma_healthHealth CheckARead-onlyIdempotent
Check if the Gamma MCP server and API are reachable and working.
Use this to verify your configuration is correct before running other tools. Returns whether the API key is valid, the API is reachable, and the account status.
Useful for:
Confirming the server is running after startup
Troubleshooting connection issues
Verifying your GAMMA_API_KEY is valid
Inputs: response_format.
gamma_list_foldersList Gamma FoldersARead-onlyIdempotent
List your Gamma folders for organizing content.
Folders help organize generated content. Use the returned folder IDs with gamma_generate's folderId parameter to save content to specific folders.
PARAMETERS:
limit: Max folders to return (1-100, default 20)
offset: Skip this many folders for pagination
RETURNS:
items: Array of folders with id, name, itemCount
total: Total number of folders
hasMore: Whether more folders are available
nextOffset: Offset for next page
EXAMPLE: { limit: 20, response_format: "json" }
Inputs: limit, offset, response_format.
gamma_list_themesList Gamma ThemesARead-onlyIdempotent
List available visual themes for Gamma content.
Themes control the visual styling of generated content including colors, fonts, and layouts. Use the returned theme IDs with gamma_generate's themeId parameter.
PARAMETERS:
limit: Max themes to return (1-100, default 20)
offset: Skip this many themes for pagination
RETURNS:
items: Array of themes with id, name, description
total: Total number of themes available
hasMore: Whether more themes are available
nextOffset: Offset for next page
EXAMPLE: { limit: 10, response_format: "markdown" }
Inputs: limit, offset, response_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool serves a distinct purpose: creating from prompt or template, checking status, listing themes/folders, sharing, health check, and archiving. No overlap detected.
All tools follow the consistent pattern 'gamma_verb_noun' using snake_case, e.g., gamma_generate, gamma_list_themes, gamma_share_email.
With 8 tools, the surface is well-scoped for a Gamma content generation server, covering creation, status, discovery, sharing, and archiving without bloat.
Core lifecycle is covered (create, check, archive, share), but missing a tool to list existing generations or browse created content, which is a minor gap.
Related MCP Connectors
Create presentations, docs, sheets and meeting notes from chat. Hosted link, editor, PPTX & PDF.
Generate AI slide decks and export native PowerPoint (.pptx) and PDF presentations from chat.
Use your apps from your AI: Gmail, Slack, Google Sheets, HubSpot and 2,300+ more on your accounts.
Generate AI images, videos, music, SFX & speech in any AI assistant. Results appear inline in chat.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to generate presentations, documents, and webpages through the Gamma.app API with support for custom themes, tones, audiences, and image generation.4 npm-
- AlicenseAqualityDmaintenanceEnables generating presentations, documents, webpages, and social posts via Gamma's API with full parameter surface including templates, folders, headers/footers, and email sharing.6MIT
- FlicenseNot gradedqualityDmaintenanceEnables generating AI-powered presentations via the Gamma API directly from MCP clients like Claude for Desktop.-