# Umami MCP (local)

Read-only. Every tool retrieves data. The MCP server never accesses the database directly.

MCP server by Umami. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx add-mcp @umami/mcp
```

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

Global (for every project on this machine):

```sh
npx add-mcp @umami/mcp -g
```

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

## Where it runs

Your computer.

## What it needs

Environment variables:

- `UMAMI_URL` (optional): Self-hosted instance URL. Do not include /api in UMAMI_URL.
- `UMAMI_API_TOKEN` (optional): Self-hosted API key or login token.
- `UMAMI_API_KEY` (optional): Umami Cloud API key.

## 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.umami.is/docs/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 (Cloud)](https://syn4pse.dev/terminal/umami-mcp-cloud.md)
- Next: [Umbraco CMS Developer MCP](https://syn4pse.dev/terminal/umbraco-cms-developer-mcp.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
