ObsidianCorps Umami Analytics MCP Server

by obsidiancorpsio.github.ObsidianCorps/umami-mcpv0.1.2

Umami v3 MCP for Cloud or self-hosted analytics, with read-only, privacy-conscious defaults.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active24d ago

Install ObsidianCorps Umami Analytics MCP server

claude mcp add umami-obsidiancorps -e UMAMI_API_KEY='<umami-api-key>' -e UMAMI_TOKEN='<umami-token>' -e UMAMI_PASSWORD='<umami-password>' -e UMAMI_TWO_FACTOR_SECRET='<umami-two-factor-secret>' -- npx -y @obsidiancorps/umami-mcp

{
  "mcpServers": {
    "umami-obsidiancorps": {
      "command": "npx",
      "args": [
        "-y",
        "@obsidiancorps/umami-mcp"
      ],
      "env": {
        "UMAMI_API_KEY": "<umami-api-key>",
        "UMAMI_TOKEN": "<umami-token>",
        "UMAMI_PASSWORD": "<umami-password>",
        "UMAMI_TWO_FACTOR_SECRET": "<umami-two-factor-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "umami-obsidiancorps": {
      "command": "npx",
      "args": [
        "-y",
        "@obsidiancorps/umami-mcp"
      ],
      "env": {
        "UMAMI_API_KEY": "<umami-api-key>",
        "UMAMI_TOKEN": "<umami-token>",
        "UMAMI_PASSWORD": "<umami-password>",
        "UMAMI_TWO_FACTOR_SECRET": "<umami-two-factor-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "umami-obsidiancorps": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@obsidiancorps/umami-mcp"
      ],
      "env": {
        "UMAMI_API_KEY": "<umami-api-key>",
        "UMAMI_TOKEN": "<umami-token>",
        "UMAMI_PASSWORD": "<umami-password>",
        "UMAMI_TWO_FACTOR_SECRET": "<umami-two-factor-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "umami-obsidiancorps": {
      "command": "npx",
      "args": [
        "-y",
        "@obsidiancorps/umami-mcp"
      ],
      "env": {
        "UMAMI_API_KEY": "<umami-api-key>",
        "UMAMI_TOKEN": "<umami-token>",
        "UMAMI_PASSWORD": "<umami-password>",
        "UMAMI_TWO_FACTOR_SECRET": "<umami-two-factor-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
UMAMI_API_KEY	—	yes	Umami Cloud API key. Configure this or one self-hosted authentication mode.
UMAMI_BASE_URL	—	—	Base URL of a self-hosted Umami instance, for example https://analytics.example.com.
UMAMI_TOKEN	—	yes	Pre-issued self-hosted Umami token. Use with UMAMI_BASE_URL instead of login credentials.
UMAMI_USERNAME	—	—	Self-hosted Umami username. Use with UMAMI_BASE_URL and UMAMI_PASSWORD.
UMAMI_PASSWORD	—	yes	Self-hosted Umami password. Use with UMAMI_BASE_URL and UMAMI_USERNAME.
UMAMI_TWO_FACTOR_SECRET	—	yes	Optional Base32 TOTP setup secret for automatic Umami 3.3+ two-factor login.
UMAMI_DEFAULT_WEBSITE_ID	—	—	Optional default website UUID used when a tool call does not select a website.

Freshness

Active — last maintenance signal 24d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-15 · 24d ago · GitHub
Latest release
2026-09-03 · 37d ago · GitHub · v0.1.2
Package published
no data · npm/PyPI
Registry entry updated
2026-09-03 · 37d ago · official registry · v0.1.2

FAQ

›How do I install the ObsidianCorps Umami Analytics MCP server in Claude Code?

Run: claude mcp add umami-obsidiancorps -e UMAMI_API_KEY='<umami-api-key>' -e UMAMI_TOKEN='<umami-token>' -e UMAMI_PASSWORD='<umami-password>' -e UMAMI_TWO_FACTOR_SECRET='<umami-two-factor-secret>' -- npx -y @obsidiancorps/umami-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does ObsidianCorps Umami Analytics require an API key?

Yes. It expects UMAMI_API_KEY, UMAMI_TOKEN, UMAMI_PASSWORD, UMAMI_TWO_FACTOR_SECRET, of which 4 are secrets.

›Can I use ObsidianCorps Umami Analytics as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is ObsidianCorps Umami Analytics in the official MCP registry?

Yes, as io.github.ObsidianCorps/umami-mcp.