About Storyblok MCP
Storyblok MCP is an MCP server published by harlley in the AI category: a Model Context Protocol (MCP) implementation for Storyblok that allows you to manage components through natural language descriptions.
The repository has 9 stars and 2 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/harlley/storyblok-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Storyblok MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 3 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
Storyblok MCP
A Model Context Protocol (MCP) implementation for Storyblok that allows you to manage components through natural language descriptions.
Features
- Create Storyblok components using natural language descriptions
- Update existing components with new fields and properties
- List all available components
- Smart schema generation from descriptions
- Support for various field types (text, richtext, asset, multilink, etc.)
Setup
- Clone the repository:
git clone [repository-url]
cd storyblok-mcp
- Install dependencies:
npm install
- Configure environment variables:
cp .env.example .env
Edit .env and add your Storyblok credentials:
STORYBLOK_SPACE_ID: Your Storyblok space IDSTORYBLOK_API_KEY: Your Storyblok API key
Usage
Start the MCP server:
npm start
Creating Components
Create components by providing a description with display name and schema:
display:Component Name
schema:
field1 (text)
field2 (richtext)
field3 (asset)
field4 (multilink)
Updating Components
Update components by specifying their ID and new properties:
display:New Display Name
schema:
newField1 (text)
newField2 (richtext)
Supported Field Types
- text: Simple text field
- textarea: Multi-line text field
- richtext: Rich text editor
- markdown: Markdown editor
- number: Numeric input
- datetime: Date and time picker
- boolean: True/false toggle
- asset: File/image selector
- multilink: Link selector
- bloks: Nested components
Development
Run in development mode with auto-reload:
npm run dev
Run tests:
npm test
Cursor MCP Setup
To use this MCP in Cursor, you need to configure it in your Cursor MCP settings:
{
"mcpServers": {
"Storyblok MCP": {
"command": "npx",
"args": [
"tsx",
"/path/to/your/storyblok-mcp/src/main.ts"
],
"env": {
"STORYBLOK_SPACE_ID": "your_space_id",
"STORYBLOK_API_KEY": "your_api_key"
}
}
}
}
Replace:
/path/to/your/storyblok-mcpwith the actual path where you cloned this repositoryyour_space_idwith your Storyblok space IDyour_api_keywith your Storyblok API key
After saving the configuration, restart Cursor for the changes to take effect. You can then use natural language commands to manage your Storyblok components directly from Cursor.
README fetched from the repository 3 days ago. The original is authoritative.