About slidespeak-mcp
slidespeak-mcp is an MCP server for creating PowerPoint presentations with SlideSpeak. It supports report and slide-deck automation and can be used as a remote service or run locally with Docker.
Key features
- 01Create PowerPoint presentations
- 02Automate reports and slide decks
- 03Connect remotely or run with Docker
Use cases
- 01Generate a presentation from a report
- 02Automate creation of slide decks
MCP support
It exposes SlideSpeak presentation creation through MCP tools for compatible clients. It can be configured to connect to the remote MCP endpoint or run locally with Docker.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
docker run -i --rm -e SLIDESPEAK_API_KEY slidespeak/slidespeak-mcp:latestSLIDESPEAK_API_KEYSecretLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEslidespeak-mcp
An MCP Server that allows you to create PowerPoint presentations. Powered by SlideSpeak, you can now create presentations using the SlideSpeak MCP. Automate reports, presentations an other slide decks. Start today!
Usage with Claude Desktop
To use this with Claude Desktop, add the following to your claude_desktop_config.json:
Remote MCP
This is the easiest way to run the MCP. This approach requires you to have Node.js installed on your system.
(Download Node.js for free here)
{
"mcpServers": {
"slidespeak": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.slidespeak.co/mcp",
"--header",
"Authorization: Bearer YOUR-SLIDESPEAK-API-KEY-HERE"
],
"timeout": 300000
}
}
}
Docker
This will allow you to run the MCP Server on your own computer. This approach requires Docker to be installed on your system.
(Download Docker Desktop for free here)
{
"mcpServers": {
"slidespeak": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SLIDESPEAK_API_KEY",
"slidespeak/slidespeak-mcp:latest"
],
"env": {
"SLIDESPEAK_API_KEY": "YOUR-SLIDESPEAK-API-KEY-HERE"
}
}
}
}
Getting an API key
Visit this page in order to get an API key for Slidespeak: https://slidespeak.co/slidespeak-api/
Development of SlideSpeak MCP
The following information is related to development of the SlideSpeak MCP. These steps are not needed to use the MCP.
Building the Docker Image
This is for local testing, if you want to publish a new docker container check out the "Making a new version" section below.
docker build . -t slidespeak/slidespeak-mcp:TAG-HERE
Development
Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
Create virtual environment and activate it
uv venv source .venv/bin/activate
Install dependencies
uv pip install -r requirements.txt
Using the server directly without Docker
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"slidespeak": {
"command": "/path/to/.local/bin/uv",
"args": [
"--directory",
"/path/to/slidespeak-mcp",
"run",
"slidespeak.py"
],
"env": {
"SLIDESPEAK_API_KEY": "API-KEY-HERE"
}
}
}
}
Making a new release
Version naming should be in the format of MAJOR.MINOR.PATCH (e.g., 1.0.0).
The version needs to be updated in the following files:
- pyproject.toml -> version
- slidespeak.py -> USER_AGENT
Make a new release in GitHub and tag it with the version number. This will trigger a GitHub Action. The release will be automatically built and pushed to Docker Hub.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.