How do I install the umami mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `UMAMI_API_KEY`, `UMAMI_API_URL`, `UMAMI_USERNAME`, `UMAMI_PASSWORD`, `UMAMI_ENABLE_WRITE`, `UMAMI_CLOUD_REGION`, `UMAMI_TEAM_ID`, `MCP_AUTH_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Umami MCP Server

Security-first MCP server for Umami analytics (Cloud + self-hosted): set up, analyze, report, and manage your instance from any MCP client.

Remote serverstreamable-httpGo

What is the Umami MCP Server?

Security-first MCP server for Umami analytics (Cloud + self-hosted): set up, analyze, report, and manage your instance from any MCP client.

The short version

…with credentials supplied via environment variables. For Umami Cloud, create an API key at Dashboard → Settings → API keys and set UMAMI_API_KEY. For self-hosted, set UMAMI_API_URL + UMAMI_USERNAME + UMAMI_PASSWORD. See MCP client setup for copy-paste configs.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
read	_(always on)_
write	UMAMI_ENABLE_WRITE=1
admin	UMAMI_ENABLE_ADMIN=1 _(self-hosted)_

How to install the Umami MCP Server

claude mcp add umami-analytics --env UMAMI_API_KEY=your-value --env UMAMI_API_URL=your-value --env UMAMI_USERNAME=your-value --env UMAMI_PASSWORD=your-value --env UMAMI_ENABLE_WRITE=your-value --env UMAMI_CLOUD_REGION=your-value --env UMAMI_TEAM_ID=your-value --env MCP_AUTH_TOKEN=your-value -- npx -y umami-analytics-mcp

Configuration

Variable	Description	Required
UMAMI_API_KEY	Credential the server authenticates with.	Yes
UMAMI_API_URL	Endpoint or connection string the server talks to.	Yes
UMAMI_USERNAME	Configuration value read at startup.	Optional
UMAMI_PASSWORD	Configuration value read at startup.	Optional
UMAMI_ENABLE_WRITE	Configuration value read at startup.	Optional
UMAMI_CLOUD_REGION	Configuration value read at startup.	Optional
UMAMI_TEAM_ID	Configuration value read at startup.	Optional
MCP_AUTH_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use Umami to Variable.”
“Use Umami to UMAMI API KEY.”
“Use Umami to UMAMI CLOUD REGION.”

Frequently asked questions

Security-first MCP server for Umami analytics (Cloud + self-hosted): set up, analyze, report, and manage your instance from any MCP client. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Umami MCP Server

Metabase

Official

Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.

DatabasesRemoteClojure★ 48.5k

Claude Pytorch Treehugger

Facilitates interaction with the PyTorch HUD API, providing access to CI/CD data, job logs, and analytics.

Analytics & ReportingPython★ 4

Buzzr Sports Engine

Local sports math, DFS settlement, bet analytics, and game-entertainment tools.

Analytics & ReportingRemoteTypeScript

LuBot Analytics

Portfolio X-Ray with ETF look-through, file analysis, and website analytics in plain English.

Analytics & ReportingRemote

Eventbrite

Eventbrite MCP server providing event management and ticketing capabilities

Analytics & ReportingTypeScript

Flit

Short links, QR codes and click analytics on Flit. Tools: create/list/stats/delete links.