# Umbraco CMS Developer MCP

An MCP (Model Context Protocol) server for Umbraco CMS that unlocks AI-powered content management.

MCP server by Umbraco. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx add-mcp @umbraco-cms/mcp-dev@17 --env 'UMBRACO_CLIENT_ID=${UMBRACO_CLIENT_ID}' --env 'UMBRACO_CLIENT_SECRET=${UMBRACO_CLIENT_SECRET}' --env 'UMBRACO_BASE_URL=${UMBRACO_BASE_URL}'
```

Works with: Claude Code, Codex CLI, Cursor, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx add-mcp @umbraco-cms/mcp-dev@17 --env 'UMBRACO_CLIENT_ID=${UMBRACO_CLIENT_ID}' --env 'UMBRACO_CLIENT_SECRET=${UMBRACO_CLIENT_SECRET}' --env 'UMBRACO_BASE_URL=${UMBRACO_BASE_URL}' -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Where it runs

Your computer.

## What it needs

Environment variables:

- `UMBRACO_CLIENT_ID` (required): ID of the Umbraco API user.
- `UMBRACO_CLIENT_SECRET` (required): Secret for that API user.
- `UMBRACO_BASE_URL` (required): Your Umbraco instance URL, e.g. https://localhost:{port}.
- `UMBRACO_INCLUDE_TOOL_COLLECTIONS` (optional): Limits which tool collections load.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Needs a key or account: It asks for an API key or a sign in before it works.

## Source

[Open the source](https://docs.umbraco.com/umbraco-developer-mcp). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

- Previous: [Umami MCP (local)](https://syn4pse.dev/terminal/umami-mcp-local.md)
- Next: [Unified MCP](https://syn4pse.dev/terminal/unified-mcp.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
