A developer focused model context protocol (MCP) server for Umbraco CMS
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add umbraco-cms-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~/.codex/config.toml
[mcp_servers.umbraco-cms-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>" }
# codex mcp add umbraco-cms-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~/.cursor/mcp.json
{
"mcpServers": {
"umbraco-cms-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>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"umbraco-cms-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>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"umbraco-cms-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>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"umbraco-cms-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>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"umbraco-cms-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>"
}
}
}
}Environment variables
UMBRACO_CLIENT_IDUMBRACO_CLIENT_SECRETUMBRACO_BASE_URL
Replace the placeholders with your own credentials and keep them out of version control.