Dev MCP Server
by umbracoio.github.umbraco/Umbraco-CMS-MCP-Devv18.0.1
A developer focused model context protocol (MCP) server for Umbraco CMS
context tax
queued
security
queued
cold start
queued
freshness
Active18d ago
Install Dev MCP server
Install in Claude Code
claude mcp add dev-umbraco -e UMBRACO_CLIENT_ID='<umbraco-client-id>' -e UMBRACO_CLIENT_SECRET='<umbraco-client-secret>' -e UMBRACO_BASE_URL='<umbraco-base-url>' -- npx -y @umbraco-cms/mcp-devInstall in Cursor
{
"mcpServers": {
"dev-umbraco": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"dev-umbraco": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"dev-umbraco": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"dev-umbraco": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| UMBRACO_CLIENT_ID | yes | yes | Umbraco API user client ID |
| UMBRACO_CLIENT_SECRET | yes | yes | Umbraco API user client secret |
| UMBRACO_BASE_URL | yes | — | 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. |
Freshness
Active — last maintenance signal 18d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-22 · 18d ago · GitHub
Latest release
2026-09-22 · 18d ago · GitHub · v18.1.7
Package published
no data · npm/PyPI
Registry entry updated
2026-07-08 · 3mo ago · official registry · v18.0.1
FAQ
›How do I install the Dev MCP server in Claude Code?
Run: claude mcp add dev-umbraco -e UMBRACO_CLIENT_ID='<umbraco-client-id>' -e UMBRACO_CLIENT_SECRET='<umbraco-client-secret>' -e UMBRACO_BASE_URL='<umbraco-base-url>' -- npx -y @umbraco-cms/mcp-dev. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Dev require an API key?
Yes. It expects UMBRACO_CLIENT_ID, UMBRACO_CLIENT_SECRET, UMBRACO_BASE_URL, of which 2 are secrets.
›Can I use Dev as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Dev in the official MCP registry?
Yes, as io.github.umbraco/Umbraco-CMS-MCP-Dev.