hypescale/storyblok-mcp-server

A TypeScript Model Context Protocol server for the Storyblok Management API. It lets AI assistants and agents manage Storyblok content, workflows, and configuration safely and programmatically.
Why this project
Storyblok is powerful, but repetitive content operations and release workflows can be time-consuming. This server bridges MCP-compatible assistants with Storyblok so teams can:
- Automate content ops (bulk updates, tagging, assets)
- Orchestrate releases and workflows with less manual effort
- Keep component libraries and schemas consistent
- Give AI agents structured, typed access to Storyblok
Highlights
- **160 tools across 30 modules** mapped to Storyblok Management API capabilities
- **Typed schemas** with Zod for safer tool calls
- **MCP-first design** for MCP-compatible clients
- **Simple config** using environment variables
What it does in 15 seconds
**Prompt**
**Response (example)**
Quick Start
Create a .env file from the example and fill in your credentials:
Then start the server:
Requirements
- Node.js >= 20
- A Storyblok space with Management + Public/Preview tokens
Configuration
The server requires three environment variables (see .env.example):
What they are used for:
| Variable | Description |
|----------|-------------|
| STORYBLOK_SPACE_ID | Your numeric Storyblok space ID |
| STORYBLOK_MANAGEMENT_TOKEN | Management API token with appropriate permissions |
| STORYBLOK_DEFAULT_PUBLIC_TOKEN | Public/Preview token for content delivery |
Tip: Use the smallest permission set possible for safety.
Usage with MCP Clients
This server is designed to work with any MCP-compatible client. Here are ready-to-copy configs for popular tools.
Claude Desktop
Show config
Add to your claude_desktop_config.json:
Codex CLI / IDE
Show config
Codex supports MCP servers via CLI or by editing ~/.codex/config.toml. The CLI and IDE extension share the same config.
Option A: Configure with the Codex CLI
Option B: Configure with ~/.codex/config.toml
Cursor
Show config
Create a project config at .cursor/mcp.json (or use the global config at ~/.cursor/mcp.json):
Windsurf
Show config
Create ~/.codeium/mcp_config.json:
VS Code
Show config
Create .vscode/mcp.json in your workspace:
Continue
Show config
Create a YAML config at .continue/mcpServers/storyblok.yaml:
Cline
Show config
Open Cline settings and use "Configure MCP Servers" to open cline_mcp_settings.json, then add:
Available Tools
The tool surface mirrors Storyblok's Management API. Total tool count and modules are defined in src/tools/index.ts.
| Module | Tools | Description |
|--------|-------|-------------|
| Stories | 18 | CRUD, bulk operations, publishing, versioning |
| Components | 9 | Schema management, versioning, usage tracking |
| Assets | 9 | Upload, organize, bulk operations |
| Workflows | 6 | Workflow management and stages |
| Releases | 5 | Release scheduling and deployment |
| Datasources | 5 | Key-value data management |
| Tags | 5 | Content tagging and organization |
| Webhooks | 5 | Event notifications |
| Collaborators | 4 | Team management |