Slidespeak MCP

What is Slidespeak MCP about?

Slidespeak MCP provides a server that accepts MCP calls to create and manipulate PowerPoint files. It connects to the Slidespeak API, turning structured data or prompts into fully‑formatted presentation decks.

How to use Slidespeak MCP?

• Remote (recommended) – add the following to claude_desktop_config.json. The configuration uses npx for easy execution.

{
  "mcpServers": {
    "slidespeak": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.slidespeak.co/mcp",
        "--header",
        "Authorization: Bearer <YOUR_SLIDESPEAK_API_KEY>"
      ]
    }
  }
}

• Docker – run the official image on any host with Docker installed.

{
  "mcpServers": {
    "slidespeak": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLIDESPEAK_API_KEY",
        "slidespeak/slidespeak-mcp:latest"
      ],
      "env": {
        "SLIDESPEAK_API_KEY": "<YOUR_SLIDESPEAK_API_KEY>"
      }
    }
  }
}

• Direct run (no Docker) – install uv, create a virtual environment, install dependencies, then execute slidespeak.py.

Key features of Slidespeak MCP

• Turn API calls into ready‑to‑present PowerPoint files.
• Supports remote execution via a simple npx command.
• Docker image for isolated, reproducible deployments.
• Fully configurable through environment variables or request headers.
• Integrated with Claude Desktop for seamless workflow automation.
• Versioned releases trigger GitHub Actions that auto‑publish new Docker tags.

Use cases of Slidespeak MCP

• Automated generation of weekly or monthly business reports.
• Dynamic slide decks for marketing campaigns driven by real‑time data.
• CI/CD pipelines that produce presentation artifacts after test runs.
• Educational content creation where lesson outlines are turned into PPTs.
• Rapid prototyping of pitch decks directly from structured prompts.

FAQ from the Slidespeak MCP

Q: Where do I obtain an API key? A: Visit https://slidespeak.co/slidespeak-api/ and generate a key from your account dashboard.

Q: Do I need Node.js installed? A: Only for the remote npx setup. Docker and direct‑run options do not require Node.js.

Q: How are new releases handled? A: Update the version in pyproject.toml and slidespeak.py, tag the commit, and GitHub Actions will build and push the Docker image.

Q: Can I run the server locally without Docker? A: Yes – install uv, create a virtual environment, install the Python dependencies, and execute slidespeak.py as shown in the README.

Q: What environment variable holds the API key for Docker? A: SLIDESPEAK_API_KEY.

slidespeak-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.

https://hub.docker.com/r/slidespeak/slidespeak-mcp