+
Skip to content

datocms/mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

👉 Visit the DatoCMS homepage or see What is DatoCMS?


DatoCMS MCP Server

⚠️ Alpha Release: This server is in early development. Features may change and stability is not guaranteed.

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.

Key Features

  • 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.

Requirements

  • Node.js 18 or newer
  • VS Code, Cursor, Windsurf, Claude Desktop, Goose or any other MCP client

Getting started

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

Click the button to install:

Install MCP Server

Or install manually:

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

Click the button to install:

Install in VS Code

Or install manually:

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.

Configuration

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"]
    }
  }
}

Tools

The DatoCMS MCP server provides the following tools:

Documentation & Exploration 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

Execution Tools (require an API token with appropriate permission)

  • 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.)

License

The package is available as open source under the terms of the MIT License.


What is DatoCMS?

DatoCMS - The Headless CMS for the Modern Web

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:

Official Libraries:

Official Framework Integrations

Helpers to manage SEO, images, video and Structured Text coming from your DatoCMS projects:

Additional Resources:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  
点击 这是indexloc提供的php浏览器服务,不要输入任何密码和下载