@tarasrushchak/storyblok-mcp-server

Universal Model Context Protocol (MCP) server for Storyblok CMS. Manage components, stories, assets, datasources, and spaces directly from AI-powered tools like Claude Code, Cursor, GitHub Copilot, and more.

Features

• 25 tools across 5 categories
• Works with any Storyblok space — not tied to a specific project
• Supports all Storyblok regions (EU, US, CA, AP)
• Full CRUD for components and stories
• Publish/unpublish workflow
• Asset and datasource management

Quick Start

Claude Code

claude mcp add --scope user -e STORYBLOK_PERSONAL_ACCESS_TOKEN=your-token -e STORYBLOK_SPACE_ID=your-space-id storyblok -- npx -y @tarasrushchak/storyblok-mcp-server

Cursor / VS Code

Add to your .mcp.json or MCP settings:

{
  "mcpServers": {
    "storyblok": {
      "command": "npx",
      "args": ["-y", "@tarasrushchak/storyblok-mcp-server"],
      "env": {
        "STORYBLOK_PERSONAL_ACCESS_TOKEN": "your-token",
        "STORYBLOK_SPACE_ID": "your-space-id",
        "STORYBLOK_REGION": "eu"
      }
    }
  }
}

Docker

docker run -e STORYBLOK_PERSONAL_ACCESS_TOKEN=your-token \
  -e STORYBLOK_SPACE_ID=your-space-id \
  @tarasrushchak/storyblok-mcp-server

Configuration

Variable	Required	Description
STORYBLOK_PERSONAL_ACCESS_TOKEN	Yes	Personal access token from Storyblok settings
STORYBLOK_SPACE_ID	Yes*	Space ID (found in Space Settings or URL). Required for space-specific tools.
STORYBLOK_REGION	No	Region: eu (default), us, ca, ap

Tools

Spaces (2 tools)

Tool	Description
list_spaces	List all spaces accessible with the current token
get_space	Get space details (name, plan, languages, etc.)

Components (7 tools)

Tool	Description
list_components	List all components with their fields
get_component	Get full component schema definition
create_component	Create a new component with schema fields
update_component	Update component schema or properties
delete_component	Delete a component
list_component_groups	List all component groups
create_component_group	Create a new component group

Stories (7 tools)

Tool	Description
list_stories	List stories with filtering (by slug, content type, folder, etc.)
get_story	Get story with full content
create_story	Create a new story/content entry
update_story	Update story content or properties
delete_story	Delete a story
publish_story	Publish a story (make draft live)
unpublish_story	Unpublish a story (revert to draft)

Assets (4 tools)

Tool	Description
list_assets	List assets with search and folder filtering
get_asset	Get asset details (filename, size, metadata)
delete_asset	Delete an asset
list_asset_folders	List asset folders

Datasources (5 tools)

Tool	Description
list_datasources	List all datasources
get_datasource_entries	Get key-value entries of a datasource
create_datasource	Create a new datasource
create_datasource_entry	Add a key-value entry to a datasource
delete_datasource	Delete a datasource

Examples

Create a component

"Create a Button component in Storyblok with fields: label (text, required),
url (text), variant (option: primary/secondary/tertiary), size (option: sm/md/lg),
and icon (image)"

List stories by content type

"List all stories using the 'page' component"

Manage content

"Create a new blog post with title 'Getting Started' and publish it"

Development

git clone https://github.com/TarasKhust/storyblok-mcp-server.git
cd storyblok-mcp-server
npm install

# Copy and configure environment
cp .env.example .env
# Edit .env with your credentials

# Run in development
npm run dev

# Build
npm run build
npm start

License

GPL-2.0