gamma-mcp
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 create a presentation about AI in healthcare"
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
MCP server for Gamma.app - AI-powered presentation, document, and website generation.
Features
Generate from scratch - Create presentations, documents, social posts, or webpages from text
Create from template - Adapt existing Gamma templates with new content
List themes - Browse available themes for styling
List folders - Browse workspace folders for organization
Poll generation status - Check when async generation completes
Related MCP server: Gamma MCP Server
Installation
npm install @purple-horizons/gamma-mcpOr clone and build:
git clone https://github.com/Purple-Horizons/gamma-mcp.git
cd gamma-mcp
npm install
npm run buildConfiguration
Environment Variable
Set your Gamma API key:
export GAMMA_API_KEY=sk-gamma-xxxxxxxxGet your API key from Gamma Account Settings (requires Pro, Ultra, Teams, or Business plan).
Claude Desktop / OpenClaw
Add to your MCP config:
{
"mcpServers": {
"gamma": {
"command": "node",
"args": ["/path/to/gamma-mcp/dist/index.js"],
"env": {
"GAMMA_API_KEY": "sk-gamma-xxxxxxxx"
}
}
}
}mcporter
Add to ~/.config/mcporter/mcporter.json:
{
"servers": {
"gamma": {
"command": "node",
"args": ["/path/to/gamma-mcp/dist/index.js"],
"env": {
"GAMMA_API_KEY": "sk-gamma-xxxxxxxx"
}
}
}
}Tools
gamma_generate
Generate a new gamma from text input.
Parameters:
inputText(required) - Content to generate from (text + image URLs)textMode(required) -generate|condense|preserveformat-presentation|document|social|webpagethemeId- Theme ID (fromgamma_list_themes)numCards- Number of slides (1-60 for Pro, 1-75 for Ultra)cardSplit-auto|inputTextBreaksadditionalInstructions- Extra generation guidancefolderIds- Array of folder IDs to save toexportAs-pdf|pptxtextAmount-brief|medium|detailed|extensivetextTone- Tone description (e.g., "professional, inspiring")textAudience- Target audiencetextLanguage- Language code (default: "en")imageSource-aiGenerated|pictographic|pexels|giphy|webAllImages|webFreeToUse|webFreeToUseCommercially|placeholder|noImagesimageModel- AI model for images (e.g., "flux-1-pro", "imagen-4-pro")imageStyle- Image style descriptiondimensions- Card dimensions (format-dependent)
Returns: { generationId: "..." }
gamma_get_generation
Check generation status.
Parameters:
generationId(required) - ID from gamma_generate
Returns:
{
"status": "pending" | "completed",
"generationId": "...",
"gammaUrl": "https://gamma.app/docs/...",
"credits": { "deducted": 150, "remaining": 3000 }
}gamma_create_from_template
Create a gamma based on an existing template.
Parameters:
gammaId(required) - Template gamma IDprompt(required) - Instructions and contentthemeId- Override themefolderIds- Destination foldersexportAs-pdf|pptximageModel- AI model for new imagesimageStyle- Style for new images
Returns: { generationId: "..." }
gamma_list_themes
List available themes.
Parameters:
query- Search by namelimit- Max results (default 50)after- Pagination cursor
Returns:
{
"data": [{ "id": "...", "name": "...", "type": "standard|custom" }],
"hasMore": false,
"nextCursor": null
}gamma_list_folders
List workspace folders.
Parameters:
query- Search by namelimit- Max results (default 50)after- Pagination cursor
Returns:
{
"data": [{ "id": "...", "name": "..." }],
"hasMore": false,
"nextCursor": null
}Usage Example
// 1. Generate a presentation
const gen = await gamma_generate({
inputText: "5 ways AI is transforming healthcare",
textMode: "generate",
format: "presentation",
numCards: 10,
imageSource: "aiGenerated",
imageStyle: "modern, professional photography"
});
// 2. Poll for completion
let status;
do {
await sleep(5000);
status = await gamma_get_generation({ generationId: gen.generationId });
} while (status.status === "pending");
// 3. Use the result
console.log(status.gammaUrl); // https://gamma.app/docs/xxxxxCredits
Gamma uses a credit-based system:
~3-4 credits per card
~2-120 credits per image (depends on model)
Check your remaining credits in the generation response.
License
MIT
Available Tools
5 toolsgamma_create_from_templateB
Create a new gamma based on an existing template. Adapts content to match template structure.
Inputs: prompt (required), gammaId (required), themeId, exportAs, +3 more.
gamma_generateA
Generate a new presentation, document, social post, or webpage from text input. Returns a generationId to poll for completion.
Inputs: textMode (required), inputText (required), format, themeId, +13 more.
gamma_get_generationA
Check the status of a gamma generation. Poll until status is 'completed'.
Inputs: generationId (required).
gamma_list_foldersA
List folders in your workspace. Use the returned IDs for folderIds parameter.
Inputs: after, limit, query.
gamma_list_themesA
List available themes in your workspace. Use the returned IDs for themeId parameter.
Inputs: after, limit, query.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: creating from template, generating new content, polling status, listing folders, and listing themes. No overlap.
All tools follow a consistent 'gamma_verb_noun' pattern, with verbs like create_from_template, generate, get_generation, list_folders, list_themes.
Five tools is well-scoped for a presentation/document generation server, covering creation, status polling, and resource listing without excess.
Covers the core workflow (generate, poll, list resources), but is missing delete or update operations for folders or themes, which are minor gaps.
Related MCP Connectors
Generate, edit, and export AI presentations to PDF, PPTX, or a shareable link.
Generate AI slide decks and export native PowerPoint (.pptx) and PDF presentations from chat.
Create presentations, docs, sheets and meeting notes from chat. Hosted link, editor, PPTX & PDF.
AI presentations in your brand from a prompt, text or file; present by link, export PDF and PPTX
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.-