What it does
umami-mcp connects MCP clients such as Claude Code, Cursor or other MCP-compatible tools to a Umami Analytics v3 instance. It covers stats and the v3 report types: funnel, retention, journey, goal, revenue, attribution and UTM. It starts in read mode. The write mode adds creating and updating websites and teams, and the admin mode adds user management. Deleting a website or resetting data requires a separate opt-in flag. Tools outside the active mode are not registered, so the model never sees them. Deleting a website also requires a domain confirmation that is checked against the live record.
Use it to ask an AI client about traffic, reports and attribution on a self-hosted Umami instance, or when a tool needs to manage websites and users with limited permissions. The publisher notes that Umami 3.4 and later ship an official MCP server for read-only analytics, and that this project targets the write and admin tasks that server leaves out.
Setup offers three routes: a hosted instance, a run from source, or Docker. The hosted option uses a consent screen for your Umami URL and sign-in. Running from source requires Node 20 or newer, and credentials are kept in a local file. Credentials are read only from the environment, and the server only contacts the UMAMI_URL you set. Passwords, tokens and JWTs are removed from errors and responses.
Limitations and requirements
Requires a Umami 3.x instance and an API key, password or OAuth sign-in. Source installs need Node 20 or newer. Plaintext HTTP is accepted only for localhost; remote hosts must use HTTPS. The server warns if its credentials file is readable by other users. Write, admin and destructive actions need the matching mode or the UMAMI_MCP_ALLOW_DESTRUCTIVE=true flag. The npm package is not published yet.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.Asif2BD/umami-mcp
Query Umami Analytics v3 — stats, funnels, retention, attribution, UTM. Read-only by default.
v0.1.3As shown on registry.modelcontextprotocol.io when we last read it