Skip to content
MCP server

Umbraco CMS MCP Dev

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
18.0.1
Listing updated
5 days ago

About Umbraco CMS MCP Dev

Umbraco CMS MCP Dev is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add umbraco-cms-mcp-dev --env UMBRACO_CLIENT_ID='<UMBRACO_CLIENT_ID>' --env UMBRACO_CLIENT_SECRET='<UMBRACO_CLIENT_SECRET>' --env UMBRACO_BASE_URL='<UMBRACO_BASE_URL>' -- npx -y @umbraco-cms/mcp-dev

Add to claude_desktop_config.json

{
  "mcpServers": {
    "umbraco-cms-mcp-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
        "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
        "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "umbraco-cms-mcp-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
        "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
        "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "umbraco-cms-mcp-dev": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
        "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
        "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "umbraco-cms-mcp-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
        "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
        "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "umbraco-cms-mcp-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "<UMBRACO_CLIENT_ID>",
        "UMBRACO_CLIENT_SECRET": "<UMBRACO_CLIENT_SECRET>",
        "UMBRACO_BASE_URL": "<UMBRACO_BASE_URL>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • UMBRACO_CLIENT_IDUmbraco API user client IDRequired
  • UMBRACO_CLIENT_SECRETUmbraco API user client secretRequired
  • UMBRACO_BASE_URLBase URL of your Umbraco instanceRequired
  • UMBRACO_INCLUDE_TOOL_COLLECTIONSComma-separated list of tool collections to include (e.g., document,media,document-type)
  • UMBRACO_READONLYEnable readonly mode to disable all write operations (create, update, delete). Only read and query tools remain available.

Pricing

Open source

Umbraco CMS MCP Dev FAQ

Is Umbraco CMS MCP Dev free?

Yes. Umbraco CMS MCP Dev is open source, so you can use and self-host it for free.

How do I add Umbraco CMS MCP Dev to Claude Code?

Run this command in your terminal: claude mcp add umbraco-cms-mcp-dev --env UMBRACO_CLIENT_ID='<UMBRACO_CLIENT_ID>' --env UMBRACO_CLIENT_SECRET='<UMBRACO_CLIENT_SECRET>' --env UMBRACO_BASE_URL='<UMBRACO_BASE_URL>' -- npx -y @umbraco-cms/mcp-dev

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers