Skip to content
MCP server

ObsidianCorps Umami Analytics

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
4 days ago

About ObsidianCorps Umami Analytics

ObsidianCorps Umami Analytics is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add umami-mcp --env UMAMI_API_KEY='<UMAMI_API_KEY>' --env UMAMI_TOKEN='<UMAMI_TOKEN>' --env UMAMI_PASSWORD='<UMAMI_PASSWORD>' --env UMAMI_TWO_FACTOR_SECRET='<UMAMI_TWO_FACTOR_SECRET>' -- npx -y @obsidiancorps/umami-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "umami-mcp": {
      "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

{
  "mcpServers": {
    "umami-mcp": {
      "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

{
  "servers": {
    "umami-mcp": {
      "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 ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "umami-mcp": {
      "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 your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "umami-mcp": {
      "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>"
      }
    }
  }
}

Configuration

  • UMAMI_API_KEYUmami Cloud API key. Configure this or one self-hosted authentication mode.
  • UMAMI_BASE_URLBase URL of a self-hosted Umami instance, for example https://analytics.example.com.
  • UMAMI_TOKENPre-issued self-hosted Umami token. Use with UMAMI_BASE_URL instead of login credentials.
  • UMAMI_USERNAMESelf-hosted Umami username. Use with UMAMI_BASE_URL and UMAMI_PASSWORD.
  • UMAMI_PASSWORDSelf-hosted Umami password. Use with UMAMI_BASE_URL and UMAMI_USERNAME.
  • UMAMI_TWO_FACTOR_SECRETOptional Base32 TOTP setup secret for automatic Umami 3.3+ two-factor login.
  • UMAMI_DEFAULT_WEBSITE_IDOptional default website UUID used when a tool call does not select a website.

Pricing

Open source

ObsidianCorps Umami Analytics FAQ

Is ObsidianCorps Umami Analytics free?

Yes. ObsidianCorps Umami Analytics is open source, so you can use and self-host it for free.

How do I add ObsidianCorps Umami Analytics to Claude Code?

Run this command in your terminal: claude mcp add umami-mcp --env UMAMI_API_KEY='<UMAMI_API_KEY>' --env UMAMI_TOKEN='<UMAMI_TOKEN>' --env UMAMI_PASSWORD='<UMAMI_PASSWORD>' --env UMAMI_TWO_FACTOR_SECRET='<UMAMI_TWO_FACTOR_SECRET>' -- npx -y @obsidiancorps/umami-mcp

What are the best alternatives to ObsidianCorps Umami Analytics?

The closest alternatives to ObsidianCorps Umami Analytics are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to ObsidianCorps Umami Analytics

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media