👉 Visit the DatoCMS homepage or see What is DatoCMS?
A local Model Context Protocol (MCP) server that provides AI assistants with tools to interact with the DatoCMS Content Management API. This server enables LLMs to explore and execute DatoCMS API operations through structured documentation and safe execution capabilities.
- Comprehensive API exploration. Browse all DatoCMS resources, actions, and methods with live documentation.
- Safe execution environment. Built-in usage rules and guardrails prevent API misuse.
- Optional project access. Use with or without API token for documentation vs. execution capabilities.
- Node.js 18 or newer
- VS Code, Cursor, Windsurf, Claude Desktop, Goose or any other MCP client
First, install the DatoCMS MCP server with your client.
Standard config works in most of the tools:
{
"mcpServers": {
"datocms": {
"command": "npx",
"args": [
"-y",
"@datocms/mcp@latest"
],
"env": {
"DATOCMS_API_TOKEN": "your-project-api-token-here"
}
}
}
}
Claude Code
Use the Claude Code CLI to add the DatoCMS MCP server:
claude mcp add datocms npx @datocms/mcp@latest -e DATOCMS_API_TOKEN=your-project-api-token-here
Claude Desktop
Follow the MCP install guide, use the standard config above.
Cursor
Go to Cursor Settings
-> Tools & Integrations
-> New MCP Server
, then paste the following:
{
"mcpServers": {
"DatoCMS": {
"command": "npx -y @datocms/mcp@latest",
"env": {
"DATOCMS_API_TOKEN": ""
},
"args": []
}
}
}
Gemini CLI
Follow the MCP install guide, use the standard config above.
VS Code
Follow the MCP install guide, use the standard config above. You can also install the DatoCMS MCP server using the VS Code CLI:
# For VS Code
code --add-mcp '{"name":"datocms","command":"npx","args":["-y", "@datocms/mcp@latest"], "env": {"DATOCMS_API_TOKEN": ""}}'
After installation, the DatoCMS MCP server will be available for use with your GitHub Copilot agent in VS Code.
Windsurf
Follow Windsurf MCP documentation. Use the standard config above.
The DatoCMS MCP server supports one optional environment variable:
DATOCMS_API_TOKEN
: Your DatoCMS API token for a specific project. When provided, enables read/write operations on your DatoCMS project. Without this token, only general knowledge and API documentation tools are available.
With API token (full project access):
{
"mcpServers": {
"datocms": {
"command": "npx",
"args": ["-y", "@datocms/mcp@latest"],
"env": {
"DATOCMS_API_TOKEN": ""
}
}
}
}
Without API token (documentation only):
{
"mcpServers": {
"datocms": {
"command": "npx",
"args": ["-y", "@datocms/mcp@latest"]
}
}
}
The DatoCMS MCP server provides the following tools:
- cma_js_client_usage_rules: General usage guidelines for the MCP
- cma_js_client_resources: List all available DatoCMS API resources
- cma_js_client_resource: Get details about a specific resource (e.g., items, assets)
- cma_js_client_resource_action: Show available actions for a resource
- cma_js_client_resource_action_method: Get detailed method documentation with examples
- cma_js_client_resource_action_readonly_method_execute: Perform an read-only operation to the project
- cma_js_client_resource_action_destructive_method_execute: Perform destructive operation to the project (create, update, destroy, etc.)
The package is available as open source under the terms of the MIT License.
DatoCMS is the REST & GraphQL Headless CMS for the modern web.
Trusted by over 25,000 enterprise businesses, agencies, and individuals across the world, DatoCMS users create online content at scale from a central hub and distribute it via API. We ❤️ our developers, content editors and marketers!
Why DatoCMS?
- API-First Architecture: Built for both REST and GraphQL, enabling flexible content delivery
- Just Enough Features: We believe in keeping things simple, and giving you the right feature-set tools to get the job done
- Developer Experience: First-class TypeScript support with powerful developer tools
Getting Started:
- ⚡️ Create Free Account - Get started with DatoCMS in minutes
- 🔖 Documentation - Comprehensive guides and API references
- ⚙️ Community Support - Get help from our team and community
- 🆕 Changelog - Latest features and improvements
Official Libraries:
- Content Delivery Client - TypeScript GraphQL client for content fetching
- REST API Clients - Node.js/Browser clients for content management
- CLI Tools - Command-line utilities for schema migrations (includes Contentful and WordPress importers)
Official Framework Integrations
Helpers to manage SEO, images, video and Structured Text coming from your DatoCMS projects:
Additional Resources:
- Plugin Examples - Example plugins we've made that extend the editor/admin dashboard
- Starter Projects - Example website implementations for popular frameworks
- All Public Repositories