Skip to content
MCP server

Umami MCP

Query Umami Analytics v3 — stats, funnels, retention, attribution, UTM. Read-only by…

Runs locallyStatus and history
Install
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-mcp

Add 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.comRequired
  • UMAMI_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