Storyblok MCP Server

Storyblok MCP Server 🚀

The Storyblok MCP (Model Context Protocol) server enables your AI assistants to directly access and manage your Storyblok spaces, stories, components, assets, workflows, and more.

What Does It Do?

With the Storyblok MCP Server, your AI assistant can:

• Create - Create new stories, components, assets, datasources, tags, releases, workflows, and more.
• Read - Read all your stories, components, assets, datasources, tags, releases, workflows, and more.
• Update - Update existing/new stories, components, assets, datasources, tags, releases, workflows, and more.
• Delete - Delete specific/all your stories, components, assets, datasources, tags, releases, workflows, and more.

🚀 Features

• Full Storyblok Management: CRUD for stories, components, assets, datasources, tags, releases, workflows, and more.(Covered everything)
• Modular Tooling: Each Storyblok resource is managed by its own tool module for easy extension and maintenance.
• Meta Tool: Discover all available tools and their descriptions at runtime.
• Async & Fast: Built on httpx and FastMCP for high performance.
• Environment-based Config: Securely manage tokens and space IDs via .env.
• Bulk Operations: Efficiently update, delete, or publish multiple resources at once.

📦 Project Structure

🚀 API Coverage

🪄 Available Tools

Access Tokens

• retrieve_multiple_access_tokens: List all access tokens
• create_access_token: Create a new access token
• update_access_token: Update an existing access token
• delete_access_token: Delete an access token

Activities

• retrieve_multiple_activities: List activity logs

Approvals

• retrieve_multiple_approvals: List approvals
• create_approval: Create a new approval
• update_approval: Update an approval
• delete_approval: Delete an approval

Assets

• fetch_assets: List assets with filtering
• get_asset: Get a specific asset by ID
• delete_asset: Delete an asset
• update_asset: Update an asset
• delete_multiple_assets: Delete multiple assets
• bulk_move_assets: Move multiple assets
• bulk_restore_assets: Restore multiple assets
• init_asset_upload: Initialize asset upload
• complete_asset_upload: Complete asset upload

Assets Folder

• retrieve_multiple_asset_folders: List asset folders
• create_asset_folder: Create a new asset folder
• update_asset_folder: Update an asset folder
• delete_asset_folder: Delete an asset folder

Branch Deployments

• retrieve_multiple_branch_deployments: List branch deployments
• create_branch_deployment: Create a new branch deployment
• update_branch_deployment: Update a branch deployment
• delete_branch_deployment: Delete a branch deployment

Collaborators

• retrieve_multiple_collaborators: List collaborators
• add_collaborator: Add a collaborator
• update_collaborator: Update a collaborator
• remove_collaborator: Remove a collaborator

Components

• 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
• retrieve_component_versions: List versions of a component
• retrieve_single_component_version: Get a specific component version
• restore_component_version: Restore a component to a previous version

Components Folder

• retrieve_multiple_component_folders: List component folders
• create_component_folder: Create a new component folder
• update_component_folder: Update a component folder
• delete_component_folder: Delete a component folder

Datasource Entries

• retrieve_multiple_datasource_entries: List datasource entries
• create_datasource_entry: Create a new datasource entry
• update_datasource_entry: Update a datasource entry
• delete_datasource_entry: Delete a datasource entry

Data Sources

• retrieve_multiple_data_sources: List data sources
• create_data_source: Create a new data source
• update_data_source: Update a data source
• delete_data_source: Delete a data source

Discussions

• retrieve_multiple_discussions: List discussions
• retrieve_specific_discussion: Get a specific discussion
• retrieve_idea_discussions_comments: List idea discussion comments
• create_discussion: Create a new discussion
• retrieve_my_discussions: List my discussions

Extensions

• retrieve_all_extensions: List all extensions
• retrieve_extension: Get a specific extension
• create_extension: Create a new extension
• update_extension: Update an extension
• delete_extension: Delete an extension
• retrieve_extension_settings: Get extension settings
• retrieve_all_extension_settings: List all extension settings

Field Plugins

• retrieve_field_plugins: List field plugins
• retrieve_field_plugin: Get a specific field plugin
• create_field_plugin: Create a new field plugin
• update_field_plugin: Update a field plugin
• delete_field_plugin: Delete a field plugin

Internal Tags

• retrieve_multiple_internal_tags: List internal tags
• create_internal_tag: Create a new internal tag
• update_internal_tag: Update an internal tag
• delete_internal_tag: Delete an internal tag

Meta

• list_tools: List all available tools

Ping

• ping: Check server health

Pipelines

• retrieve_multiple_branches: List branches
• retrieve_single_branch: Get a specific branch
• create_branch: Create a new branch
• update_branch: Update a branch
• delete_branch: Delete a branch

Presets

• retrieve_multiple_presets: List field presets
• retrieve_single_preset: Get a specific preset
• create_preset: Create a new preset
• update_preset: Update a preset
• delete_preset: Delete a preset

Releases

• retrieve_multiple_releases: List releases
• retrieve_single_release: Get a specific release
• create_release: Create a new release
• update_release: Update a release
• delete_release: Delete a release

Scheduling Stories

• retrieve_multiple_story_schedules: List story schedules
• retrieve_one_story_schedule: Get a specific story schedule
• create_story_schedule: Create a new story schedule
• update_story_schedule: Update a story schedule
• delete_story_schedule: Delete a story schedule

Space

• fetch_spaces: List spaces
• get_space: Get a specific space
• create_space: Create a new space
• update_space: Update a space
• duplicate_space: Duplicate a space
• backup_space: Backup a space
• delete_space: Delete a space

Space Roles

• fetch_space_roles: List space roles
• get_space_role: Get a specific space role
• create_space_role: Create a new space role
• update_space_role: Update a space role
• delete_space_role: Delete a space role

Stories

• 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
• debug_story_access: Debug access for a story
• bulk_publish_stories: Publish multiple stories
• bulk_delete_stories: Delete multiple stories
• bulk_update_stories: Update multiple stories
• bulk_create_stories: Create multiple stories
• get_unpublished_dependencies: List unpublished dependencies
• ai_translate_story: AI-powered translation for a story
• compare_story_versions: Compare two versions of a story

Tags

• retrieve_multiple_tags: List tags
• create_tag: Create a new tag
• update_tag: Update a tag
• delete_tag: Delete a tag
• tag_bulk_association: Add tags to multiple stories

Tasks

• retrieve_multiple_tasks: List tasks
• retrieve_single_task: Get a specific task
• create_task: Create a new task
• update_task: Update a task
• delete_task: Delete a task

Webhooks

• retrieve_multiple_webhooks: List webhooks
• retrieve_single_webhook: Get a specific webhook
• add_webhook: Add a new webhook
• update_webhook: Update a webhook
• delete_webhook: Delete a webhook

Workflows

• retrieve_multiple_workflows: List workflows
• retrieve_single_workflow: Get a specific workflow
• create_workflow: Create a new workflow
• update_workflow: Update a workflow
• duplicate_workflow: Duplicate a workflow
• delete_workflow: Delete a workflow

Workflow Stage

• retrieve_multiple_workflow_stages: List workflow stages
• retrieve_single_workflow_stage: Get a specific workflow stage
• create_workflow_stage: Create a new workflow stage
• update_workflow_stage: Update a workflow stage
• delete_workflow_stage: Delete a workflow stage

Workflow Stage Changes

• retrieve_multiple_workflow_stage_changes: List workflow stage changes
• create_workflow_stage_change: Create a workflow stage change

⚡️ Quickstart

1. Clone the repo
   git clone <your-repo-url> cd storyblok-mcp-server
2. Install dependencies
   pip install -r requirements.txt
3. Configure your environment
   • Copy .env.example to .env and fill in your Storyblok credentials:
     STORYBLOK_SPACE_ID=your_space_id STORYBLOK_MANAGEMENT_TOKEN=your_management_token STORYBLOK_DEFAULT_PUBLIC_TOKEN=your_public_token
4. MCP Client Configuration
   • To use this server with Claude or any MCP client, copy the following into your claude_desktop_config.json:

• Paste this config into your Claude or MCP client to connect instantly.

Restart your Claude Desktop and chek the tools. It will show total number tools available if you connected successfully.

5. Run and Test Locally
   • You can also run and test the server locally using MCP Inspector:
   mcp run server.py

Example Questions

• "Show me all stories from storyblok"
• "Give me details about Home story"
• "Create a new story with any content"
• "Publish Home story"

🧑‍💻 Contributing

We welcome contributions! To get started:

1. Fork the repo and create your branch from master.
2. Add or improve a tool in the tools/ directory.
3. Write clear docstrings and keep code modular.
4. Use MCP Inspector for debugging
5. Open a pull request with a clear description of your changes.

Coding Guidelines

• Use type hints and docstrings for all functions and classes.
• Keep each tool focused on a single Storyblok resource.
• Handle API errors gracefully and return informative messages.
• Keep the .env file out of version control.

🤝 Credits

Built with Storyblok and FastMCP.

📄 License

MIT License. See LICENSE for details.

💬 Questions & Support

• For issues, open a GitHub issue.
• For feature requests, open a discussion or PR.
• For Storyblok API docs, see Storyblok API Reference.

Built with 💙 by Kiran