Set up the MCP server

Gamma MCP powers Gamma Connectors and integrations in popular AI tools.

Gamma MCP is a hosted server that lets AI tools create new gammas, generate multi-page Gammas, generate from templates, browse existing gammas, search gammas by content, search templates, check generation status, read existing Gamma presentations or documents, read comments, view engagement analytics, generate standalone images, edit existing gammas, and export Gammas to PDF, PPTX, or PNG on your behalf. Integrations like the Gamma connectors in Claude and ChatGPT and the Gamma app for Slack are powered by this server.

Looking for general Gamma help? This page covers MCP server setup for developers. For general guidance on using Gamma with AI assistants, see How do I use Gamma with connectors and integrations? in the Help Center.

Quick reference

• Works with any AI tool that supports the Model Context Protocol.
• Available on all Gamma plans. Generations charge credits.
• Gamma MCP supports generating from scratch, generating multi-page Gammas, generating from templates, checking generation status, generating standalone images, editing existing gammas, exporting existing gammas, browsing existing gammas, searching gammas by content, searching templates, reading gammas, reading comments, viewing engagement analytics, browsing themes, and browsing folders.
• Reading and exporting require view access to the Gamma in the connected workspace.
• Once a generation completes, its generation ID can be used to read, edit, or export the new Gamma straight away, without looking up the Gamma's file ID.
• Editing requires at least edit access to the Gamma. Each edit changes one page — the page in the URL, or the gamma's main page — and cannot add pages. One edit runs per page at a time, and Aurora gammas cannot be edited.
• Editing tools appear in the tool list when editing is available for the connected account. If they are unavailable, make changes in the Gamma app.
• Uses OAuth with Dynamic Client Registration for custom integrations.
• See MCP tools reference for full tool details, parameter tables, and authentication guidance.

Capabilities

Some platforms review app updates before making them available to users. If functionality listed here is not available in your AI tool, the latest version of the Gamma app may still be in review. This applies to applications such as ChatGPT and Codex, where OpenAI reviews each update.

Generate from scratch -- create presentations, documents, webpages, or social posts with control over text density, tone, audience, language, images, themes, layout, headers/footers, export format, and sharing permissions.

Generate a multi-page Gamma -- create one Gamma with several distinct pages under a single URL in one request, with per-page content and settings. Ideal for sales rooms, proposal sites, and microsites.

Generate from a template -- create a new gamma from an existing template gamma. By default, Gamma preserves the template's structure while adapting the content to a new audience, topic, or use case.

Check generation status -- poll long-running generation jobs until they complete or fail.

Generate standalone images -- create a single image from a text prompt as an illustration, scene, photo, or abstract graphic, with a choice of aspect ratio and optional theme branding. The image generates in the background; check its status to get the image URL. Generated images are saved to your workspace media library, and the status result can include a link to them there.

View engagement analytics -- see how a gamma is performing: total views, unique viewers, per-card engagement, and who viewed it.

Read comments -- list the comment threads and replies on an existing gamma.

Browse existing gammas -- search or list gammas and templates that already exist in the connected workspace, and search workspace templates alongside the official Gamma explore templates.

Search gammas by content -- run a full-text search over the titles and body text of gammas the user can access, with filters for creator and last-updated time. Each hit can come back with a text snippet, usually centered on the match, and the creator's name or email.

Read existing gammas -- retrieve the full content of a presentation or document when you provide a Gamma file ID or URL. This tool is read-only and cannot modify the Gamma.

Edit existing gammas -- change the content of a gamma you already have from a natural-language instruction: reword, restructure, add, or remove content. The edit runs in the background; check its status to get a summary of the changes. Edits apply to a gamma's existing pages and cannot add new pages.

Export existing gammas -- export a gamma you already have to PDF, PPTX, or PNG (PNG returns a .zip with one PNG per card). The export runs in the background; check its status to get the download link.

Browse themes -- search Gamma's theme library by name. Each theme includes tone and color keywords to help match your style.

Organize to folders -- browse or search your Gamma folders and save generated content to specific locations.

Getting started

To use a Gamma Connector, you need an AI tool with a Gamma Connector in its library and a Gamma account on any plan. The setup process varies by platform -- see Connect integrations for step-by-step instructions.

Tips for best results

• Be specific about structure: "create a 10-slide marketing strategy covering target audience, channels, budget, and metrics" works better than "make a presentation about marketing."
• Describe your style upfront: "professional and minimal," "colorful and creative," "corporate and clean."
• Specify the format: presentation, document, webpage, or social post.
• Control text density: "keep slides brief with bullet points" or "include detailed explanations."
• Mention folder names if you want content organized: "save to my Marketing folder."
• Request exports when needed: "export as PowerPoint" or "generate a PDF."
• Name the change you want when editing an existing gamma: "make the tone more formal throughout" or "replace the pricing card with our new tiers."

Request custom MCP access

Building your own integration? The Gamma MCP server uses OAuth with Dynamic Client Registration (DCR). Your platform must support DCR to connect.

Request MCP Access

The form asks for your name, email, company, use case description, OAuth redirect URIs, and a logo for the consent page (SVG, PNG, or JPEG, 256x256 px).

Connected apps request permission to create gammas, read gammas, list folders, and list themes in the selected workspace.

Redirect URI requirements: All redirect URIs must use HTTPS with a public hostname. Localhost and loopback addresses (http://localhost, http://127.0.0.1) are not accepted. For local development, point your approved hostname to 127.0.0.1 in your system's hosts file.

Troubleshooting

Authentication errors

Your connection to Gamma may have expired or been revoked. Disconnect and reconnect the Gamma connector in your AI assistant to refresh authentication.

Connection problems

Make sure you're logged into both your AI assistant and your Gamma account before connecting. If issues persist, check your network connection.

Insufficient credits

Your account doesn't have enough credits. Purchase more at Settings > Billing or upgrade your plan.

Plan limits

The maximum card count, available image models, and credits come from your workspace's current Gamma plan. When a request exceeds one of these limits, your AI assistant tells you which limit applies and links to Settings > Billing, where you can compare plans. If you upgrade, ask the assistant to retry; Gamma checks each request against your live plan.

Invalid parameters

Your AI assistant will typically retry with corrected values. If the issue persists, try rephrasing your request with simpler options.

FAQ

Connectors, MCP, and API -- which should I use?

No-code users: Use Gamma connectors in Claude or ChatGPT, or the Gamma app for Slack, for conversational creation — or Zapier/Make/n8n for automated workflows.

Developers: Use Gamma MCP if you're building a custom AI tool integration that supports MCP. Use the Gamma API if you need full programmatic control over requests and responses.

Can I edit a gamma using MCP?

When edit_gamma and get_edit_status appear in your tool list, use edit_gamma with a Gamma file ID or URL and a natural-language instruction, then poll get_edit_status for the summary of changes. Edits apply to the gamma's existing pages and cannot add new pages, and only one edit runs per page at a time. For anything the tool cannot do, edit in the Gamma app.

What can I request through Gamma MCP?

You can create new content with generate, browse existing gammas and templates with get_gammas, find gammas by their content with search_gammas, find workspace and explore templates with search_templates, create new content from a template with generate_from_template, check status with get_generation_status, generate a standalone image with generate_image (and retrieve it with get_image_generation_status), export an existing gamma to PDF, PPTX, or PNG with export_gamma (and retrieve the link with get_export_status), edit an existing gamma with edit_gamma (and check it with get_edit_status), browse themes and folders, and read existing Gamma presentations or documents with read_gamma. See the MCP tools reference for the full tool list and parameter details.

Where can I learn more about MCP?

Visit the Model Context Protocol website for technical details.

Related

• MCP tools reference for authentication, parameter tables, and error handling
• Connect integrations for platform-specific setup instructions
• Generate from text for the full parameter reference
• Access and pricing for credit costs and plan details