Kiran1689/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
| Resource | Description |
|----------------------------|--------------------------------------------------|
| Access Tokens | Manage access tokens for Storyblok API |
| Activities | Manage or retrieve activity logs |
| Approvals | Manage approval workflows |
| Assets | Manage assets (upload, update, delete, list) |
| Assets Folder | Manage asset folders |
| Branch Deployments | Manage branch deployments |
| Collaborators | Manage collaborators in a space |
| Components | Manage Storyblok components (CRUD, schema, etc.) |
| Components Folder | Manage folders for components |
| Datasource Entries | Manage entries in data sources |
| Data Sources | Manage data sources (CRUD, entries) |
| Discussions | Manage discussions and comments |
| Extensions | Manage Storyblok extensions |
| Field Plugins | Manage custom field plugins |
| Internal Tags | Manage internal tags for assets/stories |
| Meta | Meta tool: discover all available tools |
| Ping | Health check and server status |
| Pipelines | Manage pipelines for content delivery |
| Presets | Manage field presets for components |
| Releases | Manage releases (create, update, publish) |
| Scheduling Stories | Schedule stories for publishing |
| Space | Manage Storyblok space settings and info |
| Space Roles | Manage roles and permissions in a space |
| Stories | Manage stories (CRUD, bulk ops, validation) |
| Tags | Manage tags (CRUD, bulk association) |
| Tasks | Manage tasks (CRUD, webhooks, automation) |
| Webhooks | Manage webhooks (CRUD, trigger) |
| Workflows | Manage workflows and workflow stages |
| Workflow Stage | Manage individual workflow stages |
| Workflow Stage Changes | Track and manage workflow stage changes |
---
🪄 Available Tools
Access Tokens
Manage access tokens for Storyblok API
- 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
Manage or retrieve activity logs
- retrieve_multiple_activities: List activity logs
Approvals
Manage approval workflows
- retrieve_multiple_approvals: List approvals
- create_approval: Create a new approval
- update_approval: Update an approval
- delete_approval: Delete an approval
Assets
Manage assets (upload, update, delete, list)
- 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