Storyblok MCP Server

Manage Storyblok spaces, stories, components, assets, and workflows from your AI assistant.

Unverified

stdio (local)

API key

Stale

Python

View repo 40

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

pip install -r requirements.txt

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

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

About Storyblok MCP Server

A modular, extensible MCP server that wraps the Storyblok Management API, giving AI assistants full CRUD plus bulk operations over stories, components, assets, datasources, tags, releases, workflows, and many other Storyblok resources. Configured via environment variables and run over stdio with uv.

Tools & capabilities (52)

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.

unpublish_story

Unpublish a story.

get_story_versions

List versions of a story.

restore_story

Restore a story to a previous version.

validate_story_content

Validate story content.

bulk_publish_stories

Publish multiple stories at once.

bulk_delete_stories

Delete multiple stories at once.

bulk_update_stories

Update multiple stories at once.

bulk_create_stories

Create multiple stories at once.

ai_translate_story

AI-powered translation for a story.

compare_story_versions

Compare two versions of a story.

fetch_components

List components with filtering.

get_component

Get a specific component by ID.

create_component

Create a new component.

update_component

Update an existing component.

delete_component

Delete a component.

get_component_usage

Find stories using a component.

fetch_assets

List assets with filtering.

get_asset

Get a specific asset by ID.

update_asset

Update an asset.

delete_asset

Delete an asset.

init_asset_upload

Initialize an asset upload.

complete_asset_upload

Complete an asset upload.

retrieve_multiple_data_sources

List data sources.

create_data_source

Create a new data source.

retrieve_multiple_datasource_entries

List datasource entries.

retrieve_multiple_tags

List tags.

tag_bulk_association

Add tags to multiple stories.

retrieve_multiple_releases

List releases.

create_release

Create a new release.

retrieve_multiple_workflows

List workflows.

create_workflow

Create a new workflow.

retrieve_multiple_workflow_stages

List workflow stages.

retrieve_multiple_webhooks

List webhooks.

add_webhook

Add a new webhook.

fetch_spaces

List spaces.

get_space

Get a specific space.

create_space

Create a new space.

duplicate_space

Duplicate a space.

backup_space

Backup a space.

fetch_space_roles

List space roles.

retrieve_multiple_collaborators

List collaborators in a space.

retrieve_multiple_access_tokens

List access tokens for the Storyblok API.

retrieve_multiple_tasks

List tasks.

retrieve_multiple_discussions

List discussions and comments.

When to use it

Show, create, update, publish, and delete Storyblok stories through natural language
Bulk-manage content with bulk create/update/publish/delete operations
Manage components, assets, datasources, tags, releases, and webhooks in a space
Automate editorial workflows, scheduling, and approvals
AI-translate stories and compare or restore story versions

Security notes

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 FAQ

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

#storyblok #cms #headless-cms #content-management #fastmcp #python

Alternatives to Storyblok MCP Server

Compare all alternatives →

BlenderMCP

Design & Media

23k

Control Blender from Claude and other LLMs for prompt-assisted 3D modeling, scene creation, and asset generation.

Unverified

stdio (local)

No auth

Python

22 tools

Updated 16 days agoRepo

Figma Context MCP (figma-developer-mcp)

Design & Media

15k

Popular community server that feeds Figma layout data to coding agents via a Figma API token.

Verified

stdio (local)

API key

TypeScript

2 tools

Updated 1 month agoRepo

21st.dev Magic MCP

Design & Media

5.2k

Generate beautiful, modern UI components from natural-language descriptions inside your IDE.

Unverified

stdio (local)

API key

TypeScript

4 tools

Updated 4 months agoRepo

Compare Storyblok MCP Server with:

vs BlenderMCP vs Figma Context MCP (figma-developer-mcp)vs 21st.dev Magic MCP vs Shadcn UI v4 MCP Server