← Index

io.github.umbraco/Umbraco-CMS-MCP-Dev

io.github.umbraco/Umbraco-CMS-MCP-Dev·v17.3.3·Other
Quality Score
85
/100

A developer focused model context protocol (MCP) server for Umbraco CMS

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "Umbraco-CMS-MCP-Dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<your-umbraco_client_id>",
        "UMBRACO_CLIENT_SECRET": "<your-umbraco_client_secret>",
        "UMBRACO_BASE_URL": "<umbraco_base_url>",
        "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "<umbraco_include_tool_collections>",
        "UMBRACO_READONLY": "<umbraco_readonly>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "Umbraco-CMS-MCP-Dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<your-umbraco_client_id>",
        "UMBRACO_CLIENT_SECRET": "<your-umbraco_client_secret>",
        "UMBRACO_BASE_URL": "<umbraco_base_url>",
        "UMBRACO_INCLUDE_TOOL_COLLECTIONS": "<umbraco_include_tool_collections>",
        "UMBRACO_READONLY": "<umbraco_readonly>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @umbraco-cms/mcp-dev
§02  Environment variables
UMBRACO_CLIENT_ID
requiredsecret

Umbraco API user client ID

UMBRACO_CLIENT_SECRET
requiredsecret

Umbraco API user client secret

UMBRACO_BASE_URL
required

Base URL of your Umbraco instance

UMBRACO_INCLUDE_TOOL_COLLECTIONS

Comma-separated list of tool collections to include (e.g., document,media,document-type)

UMBRACO_READONLY

Enable readonly mode to disable all write operations (create, update, delete). Only read and query tools remain available.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Other