How to add Storyblok MCP Server to Windsurf

Manage Storyblok spaces, stories, components, assets, and workflows from your AI assistant. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Storyblok MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Storyblok MCP Server's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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