2slides
The MCP Server for 2slides. AI agent for PPT/Presentation/Slides generation.
Installation
npx mcp-2slidesAsk AI about 2slides
Powered by Claude Β· Grounded in docs
I know everything about 2slides. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
2slides MCP Server

Expose 2slides.com tools for MCP clients (e.g., Claude Desktop).
Get Your API Key
Before using this MCP server, you need to obtain an API key from 2slides.com/api.
Configure in Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json and add:
{
"mcpServers": {
"2slides": {
"command": "npx",
"args": ["2slides-mcp"],
"env": {
"API_KEY": "YOUR_2SLIDES_API_KEY"
}
}
}
}
Then fully restart Claude Desktop. In a chat, open the tools panel and you should see the tools below.
Available Tools
slides_generate (POST /api/v1/slides/generate)
Generate a PowerPoint presentation using a pre-built theme (Fast PPT). Use themes_search first to find a themeId.
- Args:
userInput(string, required) β presentation contentthemeId(string, required) β theme ID fromthemes_searchresponseLanguage(string, optional, default:Auto) β output language; supported values:Auto,English,Spanish,Arabic,Portuguese,Indonesian,Japanese,Russian,Hindi,French,German,Greek,Vietnamese,Turkish,Thai,Polish,Italian,Korean,Simplified Chinese,Traditional Chinesemode(optional, default:sync) βsyncreturnsdownloadUrlimmediately;asyncreturns ajobIdto poll withjobs_get
- Credits: 1 per page
- Example:
{ "themeId": "st-1756528793701-fcg5fblt2", "userInput": "Generate a 5-slide intro to machine learning", "responseLanguage": "English", "mode": "sync" }
themes_search (GET /api/v1/themes/search)
Search pre-built themes to use with slides_generate.
- Args:
query(string, required) β search keyword (e.g.business,minimal,dark)limit(number, optional, default:10, range:1β100)
- Returns: array of themes with
id,name,description,previewUrl,tags - Credits: free
- Example:
{ "query": "business", "limit": 5 }
jobs_get (GET /api/v1/jobs/{jobId})
Poll a job's status and retrieve the result when ready.
- Args:
jobId(string, required)
- Returns:
jobId,status(pending/processing/success/failed),message,downloadUrl(when success),slidePageCount,createdAt,updatedAt,duration(ms),jobUrl(Nano Banana jobs only) - Credits: free
- Note: Poll every 20 seconds until
statusissuccessorfailed. - Example:
{ "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
slides_create_like_this (POST /api/v1/slides/create-like-this)
Generate slides (Nano Banana) that match the style of a reference image.
- Args:
userInput(string, required) β presentation contentreferenceImageUrl(string, required) β URL of the style reference imageresponseLanguage(string, optional, default:Auto)aspectRatio(string, optional, default:16:9) β valid values:1:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9,21:9resolution(string, optional, default:2K) β1K,2K,4Kpage(number, optional, default:0) β0= auto-detect,1β100= exact page countcontentDetail(string, optional, default:standard) βconciseorstandardmode(string, optional, default:async) βasyncreturnsjobId;syncreturnsdownloadUrlimmediately
- Credits: 100 per page (1K/2K) or 200 per page (4K)
- Example:
{ "userInput": "Create a presentation about AI trends", "referenceImageUrl": "https://example.com/style-reference.jpg", "aspectRatio": "16:9", "resolution": "2K", "page": 5, "contentDetail": "standard", "mode": "async" }
slides_create_pdf_slides (POST /api/v1/slides/create-pdf-slides)
Generate custom-designed slides (Nano Banana) from text content without a reference image.
- Args:
userInput(string, required) β presentation contentdesignStyle(string, optional) β free-text description of the visual style; leave empty for default stylingresponseLanguage(string, optional, default:Auto)aspectRatio(string, optional, default:16:9) β valid values:1:1,2:3,3:2,3:4,4:3,4:5,5:4,9:16,16:9,21:9resolution(string, optional, default:2K) β1K,2K,4Kpage(number, optional, default:0) β0= auto-detect,1β100= exact page countcontentDetail(string, optional, default:standard) βconciseorstandardmode(string, optional, default:async) βasyncreturnsjobId;syncreturnsdownloadUrlimmediately
- Credits: 100 per page (1K/2K) or 200 per page (4K)
- Example:
{ "userInput": "Quarterly business review for Q3 2025", "designStyle": "modern, dark background, bold typography", "aspectRatio": "16:9", "resolution": "2K", "page": 8, "mode": "async" }
slides_generate_narration (POST /api/v1/slides/generate-narration)
Add AI voice narration to a completed Nano Banana job (slides_create_like_this or slides_create_pdf_slides only; Fast PPT not supported). Always async β poll result with jobs_get.
-
Args (single speaker,
mode: "single"default):jobId(string, required) β UUID of a completed Nano Banana jobmode(string, optional, default:single) βsingleormultispeakerName(string, optional) β narrator namevoice(string, optional) β one of 30 voices (see list below)contentMode(string, optional, default:standard) βconciseorstandardincludeIntro(boolean, optional, default:true)
-
Args (two speakers,
mode: "multi"):jobId(string, required)mode(string, required) βmultispeaker1Name(string, required)speaker2Name(string, required)speaker1Voice(string, optional) β voice for speaker 1speaker2Voice(string, optional) β voice for speaker 2contentMode(string, optional, default:standard) βconciseorstandard
-
Supported voices (30):
Puck,Aoede,Charon,Kore,Fenrir,Zephyr,Leda,Orus,Callirrhoe,Autonoe,Enceladus,Iapetus,Umbriel,Algieba,Despina,Erinome,Algenib,Rasalgethi,Laomedeia,Achernar,Alnilam,Schedar,Gacrux,Pulcherrima,Achird,Zubenelgenubi,Vindemiatrix,Sadachbia,Sadaltager,Sulafat -
Credits: 210 per page (10 text + 200 audio)
-
Example:
{ "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "multi", "speaker1Name": "Alice", "speaker2Name": "Bob", "speaker1Voice": "Aoede", "speaker2Voice": "Puck", "contentMode": "standard" }
slides_download_pages_voices (POST /api/v1/slides/download-slides-pages-voices)
Export slide pages and audio narration as a ZIP file. The job must be completed and have narration generated.
- Args:
jobId(string, required) β UUID of a job with completed narration
- Returns:
downloadUrl(expires in 1 hour),fileName,expiresIn(3600 seconds) - ZIP contents:
pages/ page_01.png, page_02.png, β¦ voices/ page_01.wav, page_02.wav, β¦ transcript.txt - Credits: free
- Example:
{ "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
Typical Workflows
Fast PPT (theme-based PowerPoint):
themes_searchβ get athemeIdslides_generate(sync) β getdownloadUrldirectly
Nano Banana (custom-designed slides):
slides_create_like_thisorslides_create_pdf_slides(async) β getjobIdjobs_get(poll every 20s) β getdownloadUrlwhenstatus: "success"
Nano Banana with narration:
slides_create_like_thisorslides_create_pdf_slidesβ getjobIdjobs_getβ wait for slides to completeslides_generate_narrationβ get narrationjobIdjobs_getβ wait for narration to completeslides_download_pages_voicesβ get ZIP download link
Troubleshooting (Claude Desktop)
- If tools don't appear in Claude, verify the config path is absolute and restart the app.
- Check Claude MCP logs:
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log
- For stdio MCP servers, avoid logging to stdout; this server only logs errors to stderr.
References
- Build an MCP server (official docs): https://modelcontextprotocol.io/docs/develop/build-server
- 2slides API docs: https://2slides.com/api
- 2slides: https://2slides.com
- 2slides Templates: https://2slides.com/templates
