How to add Storyblok MCP Server to Cursor

Manage Storyblok spaces, stories, components, assets, and workflows from your AI assistant. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Storyblok MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Storyblok MCP Server's tools to confirm it's connected.

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 Cursor

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

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Storyblok MCP Server config there under the "mcpServers" key and restart the client.

Is Storyblok MCP Server safe to use with Cursor?

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