How to add Storyblok MCP Server to Claude Desktop

Manage Storyblok spaces, stories, components, assets, and workflows from your AI assistant. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 40★ · stdio · apikey

Claude Desktop config for Storyblok MCP Server

pip install -r requirements.txt

{
  "mcpServers": {
    "storyblok-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "C:\\path\\to\\storyblok-mcp-server\\server.py"
      ],
      "env": {
        "STORYBLOK_SPACE_ID": "your_space_id",
        "STORYBLOK_MANAGEMENT_TOKEN": "your_management_token",
        "STORYBLOK_DEFAULT_PUBLIC_TOKEN": "your_public_token"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Storyblok MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Storyblok MCP Server's tools appear under the 🔌 tools menu.

Before you start

A Storyblok account with a space
Storyblok Management Token and public token
Python with dependencies installed (pip install -r requirements.txt)
uv installed on your system
An MCP client such as Claude Desktop

What Storyblok MCP Server can do in Claude Desktop

list_tools

Meta tool that lists all available tools and their descriptions at runtime.

ping

Health check to verify server status.

fetch_stories

List stories with filtering.

get_story

Get a specific story by ID.

create_story

Create a new story.

update_story

Update an existing story.

delete_story

Delete a story.

publish_story

Publish a story.

Security

Requires a Storyblok Management Token (full read/write access to your space) and a public token, provided via environment variables. Keep your .env out of version control. The server can create, update, and delete content as well as duplicate/backup/delete entire spaces, so scope tokens carefully.

Storyblok MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Storyblok MCP Server config there under the "mcpServers" key and restart the client.

Is Storyblok MCP Server safe to use with Claude Desktop?

What credentials does it need?

A Storyblok Space ID, a Management Token, and a default public token, supplied via the STORYBLOK_SPACE_ID, STORYBLOK_MANAGEMENT_TOKEN, and STORYBLOK_DEFAULT_PUBLIC_TOKEN environment variables.

Is this an official Storyblok product?

No. It is a community project built by Kiran1689 on top of the Storyblok Management API and FastMCP.

How do I run it locally for testing?

After installing dependencies and uv, you can run and inspect it with MCP Inspector via `mcp run server.py`.

View repo Full Storyblok MCP Server page