Storyblok

A modular, extensible MCP Server for managing Storyblok spaces, stories, components, assets, workflows, and more via the Model Context Protocol (MCP).

manage-tags-with-crud-operations-and-bulk-association.

GitHub Stars

—

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kiran1689-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"
      }
    }
  }
}

The Storyblok MCP Server lets your AI assistants directly access and manage your Storyblok spaces, stories, components, assets, workflows, and more. It enables you to perform create, read, update, and delete operations across Storyblok resources through a programmable MCP interface, making it easier to automate content workflows and integrations.

How to use

You connect your MCP client to the Storyblok MCP Server by running the local server process and exposing a control endpoint that your client can talk to. Once connected, you can perform CRUD operations across stories, components, assets, tags, releases, workflows, and many other Storyblok resources. The server exposes a wide range of tools you can call from your MCP client, including bulk operations and meta-tool discovery to see what’s available at runtime.

How to install

Prerequisites: you need Python and a runtime tool for MCP clients. You also need network access to install Python dependencies and run the local MCP server.

Clone or obtain the MCP server package and navigate to its directory.
Install the Python dependencies listed for the server.
Create a local configuration file with your Storyblok credentials and space ID.
Run the local MCP server using the provided runtime command.

Additional notes

Configuration uses environment variables to securely provide your Storyblok credentials and space information. You can run the server locally and connect with an MCP client to start issuing commands against your Storyblok resources. The server supports a broad set of resources and tools, including assets, components, stories, data sources, pipelines, webhooks, and workflows. When using a client, you may enable meta-tool discovery to list all available tools at runtime.

Security considerations: keep tokens and space IDs in secure environment variables and avoid committing them to version control. If you are exposing the server over a network, ensure you use proper authentication and restricted access.

Available tools

Access Tokens

Manage access tokens for Storyblok API with retrieve, create, update, and delete operations.

Activities

Retrieve or list activity logs related to Storyblok activity within the space.

Approvals

Handle approval workflows, including listing, creating, updating, and deleting approvals.

Assets

Manage assets: upload, update, delete, and list assets.

Assets Folder

Manage folders that organize assets.

Branch Deployments

Manage deployments for different branches of content.

Collaborators

Manage collaborators in a Storyblok space, including adding or removing members.

Components

CRUD operations for Storyblok components, including usage and versioning.

Components Folder

Manage folders for organizing components.

Datasource Entries

Manage entries within data sources.

Data Sources

Manage data sources, including CRUD and entries.

Discussions

Manage discussions and comments within the space.

Extensions

Manage Storyblok extensions (create, update, delete, and retrieve).

Field Plugins

Manage custom field plugins for components.

Internal Tags

Manage internal tags used for assets and stories.

Ping

Health check and server status endpoint.

Pipelines

Manage pipelines for content delivery, including branches.

Presets

Manage field presets for components.

Releases

Manage releases, including create, update, and publish.

Scheduling Stories

Schedule stories for publishing.

Space

Manage space settings and information.

Space Roles

Manage roles and permissions within a space.

Stories

CRUD operations for stories, with bulk and validation options.

Tasks

Manage tasks including CRUD and webhooks.

Webhooks

Manage webhooks (CRUD and triggering).

Workflows

Manage workflows and stages.

Workflow Stage

Manage individual workflow stages.

Workflow Stage Changes

Track changes within workflow stages.

Built by

VeilStrat

AI signals for GTM teams