@zgeoff/umami-mcp

A Model Context Protocol server exposing Umami analytics — Cloud and self-hosted — as read-only tools.

A TypeScript port of Alurith/umami-mcp-server (Python, MIT) by Alessandro Ferrini — tool surface and behaviour mirror the original; all credit for the design to its author.

Tools

All tools are read-only.

• get_websites — list websites, with pagination and search

• get_stats — summary statistics for a time range

• get_pageviews — pageview/session series bucketed by hour/day/month/year

• get_metrics — ranked breakdowns (url, referrer, browser, country, event, …)

• get_active — visitors active in the last 5 minutes

Related MCP server: Umami MCP Server

Configuration

Auth is one of two modes:

Usage

{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@zgeoff/umami-mcp"],
      "env": {
        "UMAMI_API_BASE": "https://your-umami.example/api",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "…"
      }
    }
  }
}

Development

npm install
npm test
npm run build