Umami MCP
Query Umami Analytics v3 — stats, funnels, retention, attribution, UTM. Read-only by…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.3
- Listing updated
- 4 days ago
About Umami MCP
Umami MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Query Umami Analytics v3 — stats, funnels, retention, attribution, UTM. Read-only by default.
Install
Run in a terminal
claude mcp add umami-mcp --env UMAMI_URL='<UMAMI_URL>' --env UMAMI_PASSWORD='<UMAMI_PASSWORD>' --env UMAMI_API_KEY='<UMAMI_API_KEY>' -- npx -y @asif2bd/umami-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_API_KEY": "<UMAMI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_API_KEY": "<UMAMI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"umami-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_API_KEY": "<UMAMI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_API_KEY": "<UMAMI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "<UMAMI_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_API_KEY": "<UMAMI_API_KEY>"
}
}
}
}Configuration
UMAMI_URLYour Umami instance URL, e.g. https://analytics.example.comRequiredUMAMI_USERNAMEUmami username. Self-hosted Umami has no API keys, so a login is required.UMAMI_PASSWORDUmami password. Prefer a dedicated, limited account over your admin login.UMAMI_API_KEYUmami Cloud API key, used instead of username and password.UMAMI_MCP_MODEPermission tier: read (default), write, or admin. Tools above the tier are never registered.
Pricing
Open source
Umami MCP FAQ
Is Umami MCP free?
Yes. Umami MCP is open source, so you can use and self-host it for free.
How do I add Umami MCP to Claude Code?
Run this command in your terminal: claude mcp add umami-mcp --env UMAMI_URL='<UMAMI_URL>' --env UMAMI_PASSWORD='<UMAMI_PASSWORD>' --env UMAMI_API_KEY='<UMAMI_API_KEY>' -- npx -y @asif2bd/umami-mcp