MMCPMarkets
CU

climactic/umami-mcp

Developer tools
6 stars 4 forks Quality 64 Trend 14MIT
Repository Install

Umami Analytics MCP - No Binaries, No Docker, Easy to Use

Overview

An MCP server for Umami Analytics that gives Claude (and any MCP-compatible client) full read/write access to your analytics data. Works with both Umami Cloud and self-hosted instances. 48 tools covering websites, stats, pageviews, metrics, sessions, events, reports (funnel, retention, goals, journey, attribution, UTM, revenue, performance, breakdown), teams, and user admin. - umami_whoami — Current authenticated user - umami_list_my_websites — Websites accessible to current user - umami_list_websites — List all websites - umami_get_website — Get website details - umami_create_website — Create a new website - umami_update_website — Update name/domain/shareId - umami_delete_website — Delete a website permanently - umami_reset_website — Wipe all data for a website - umami_get_stats — Aggregate stats (pageviews, visitors, bounces, time) - umami_get_pageviews — Pageviews + sessions time series - umami_get_metrics — Top N by dimension (url, referrer, browser, os, country, event, ...

README

@climactic/umami-mcp

An MCP server for Umami Analytics that gives Claude (and any MCP-compatible client) full read/write access to your analytics data. Works with both Umami Cloud and self-hosted instances.

48 tools covering websites, stats, pageviews, metrics, sessions, events, reports (funnel, retention, goals, journey, attribution, UTM, revenue, performance, breakdown), teams, and user admin.

Install

Claude Code (plugin)

# Add the marketplace and install
claude /plugin marketplace add climactic/umami-mcp
claude /plugin install umami-mcp@climactic

Claude Desktop / other MCP clients

Add to your mcpServers config:

{
  "mcpServers": {
    "umami": {
      "command": "bunx",
      "args": ["@climactic/umami-mcp"],
      "env": {
        "UMAMI_API_KEY": "your-api-key"
      }
    }
  }
}

Local dev

git clone https://github.com/climactic/umami-mcp.git
cd umami-mcp
bun install
UMAMI_API_KEY=your-key bun run index.ts

Auth

Set one of these env var combinations:

Umami Cloud:

Variable Required Description
UMAMI_API_KEY Yes API key from Umami Cloud dashboard
UMAMI_BASE_URL No Override API base (default: https://api.umami.is/v1)
UMAMI_DEFAULT_WEBSITE_ID No Default website UUID for tools that accept websiteId

Self-hosted:

Variable Required Description
UMAMI_BASE_URL Yes Your Umami instance URL, e.g. https://umami.example.com
UMAMI_USERNAME Yes Admin username
UMAMI_PASSWORD Yes Admin password
UMAMI_DEFAULT_WEBSITE_ID No Default website UUID

Tools

Examples

Ask Claude things like:

  • “How many pageviews did my site get this week?”
  • “What are my top 10 referrers for the last 30 days?”
  • “Show me a funnel from / to /checkout to /thank-you”
  • “What’s the retention look like for January?”
  • “Who’s on the site right now?”
  • “Create a new website for staging.example.com”

Development

bun install
bun test            # run test suite
bun run index.ts    # start the server (needs env vars)
bunx tsc --noEmit   # type check
bunx oxlint         # lint

Sponsors

If this project saves you time, consider supporting its development:

License

MIT

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "umami": { "command": "bunx", "args": ["@climactic/umami-mcp"], "env": { "UMAMI_API_KEY": "your-api-key" } } } }