# Umbraco CMS MCP Dev (MCP server)

> Umbraco CMS MCP Dev is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. A developer focused model context protocol (MCP) server for Umbraco CMS. It has 39 GitHub stars, is released under the MIT license and runs locally with npx -y @umbraco-cms/mcp-dev.

An MCP (Model Context Protocol) server for Umbraco CMS that unlocks AI-powered content management. It provides comprehensive access to the Umbraco Management API, enabling your AI agent to perform back office tasks through natural conversation - freeing you from the UI and making complex, repetitive workflows that would be tedious or impossible manually become effortless.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/umbraco/Umbraco-CMS-MCP-Dev |
| GitHub stars | 39 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @umbraco-cms/mcp-dev |
| Remote URL | none |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v18.1.7 (Sep 22, 2026) |
| Last commit | Sep 22, 2026 |
| MCP registry name | io.github.umbraco/Umbraco-CMS-MCP-Dev |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "umbraco-cms-mcp-dev": {
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "your-value",
        "UMBRACO_CLIENT_SECRET": "your-value",
        "UMBRACO_BASE_URL": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env UMBRACO_CLIENT_ID=your-value --env UMBRACO_CLIENT_SECRET=your-value --env UMBRACO_BASE_URL=your-value --transport stdio umbraco-cms-mcp-dev -- npx -y @umbraco-cms/mcp-dev
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "umbraco-cms-mcp-dev": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "your-value",
        "UMBRACO_CLIENT_SECRET": "your-value",
        "UMBRACO_BASE_URL": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "umbraco_client_id",
      "description": "UMBRACO_CLIENT_ID",
      "password": true
    },
    {
      "type": "promptString",
      "id": "umbraco_client_secret",
      "description": "UMBRACO_CLIENT_SECRET",
      "password": true
    }
  ],
  "servers": {
    "umbraco-cms-mcp-dev": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@umbraco-cms/mcp-dev"
      ],
      "env": {
        "UMBRACO_CLIENT_ID": "${input:umbraco_client_id}",
        "UMBRACO_CLIENT_SECRET": "${input:umbraco_client_secret}",
        "UMBRACO_BASE_URL": "your-value"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `UMBRACO_CLIENT_ID` (secret) (required): Umbraco API user client ID
- `UMBRACO_CLIENT_SECRET` (secret) (required): 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.

## Similar MCP servers

- [Kaneo](https://appsgit.com/mcp-servers/kaneo): Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients. (9,368 stars, MIT, official, needs API key)
- [PraisonAI](https://appsgit.com/mcp-servers/praisonai): AI Agents Framework with Self Reflection and MCP support. (9,192 stars, MIT)
- [Windows MCP](https://appsgit.com/mcp-servers/windows-mcp): An MCP Server for computer-use in Windows OS. (7,725 stars, MIT)
- [Excel MCP Server](https://appsgit.com/mcp-servers/excel-mcp-server): Create, read and edit Excel workbooks without Microsoft Excel. (4,212 stars, MIT)
- [Basic Memory](https://appsgit.com/mcp-servers/basic-memory): Local-first knowledge management with bi-directional LLM sync via Markdown files. (4,108 stars, AGPL-3.0)
- [RevoGrid DataGrid MCP](https://appsgit.com/mcp-servers/revogrid-datagrid-mcp): Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval. (3,448 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/umbraco-cms-mcp-dev
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.