umami-mcp-server MCP Server

Connect your Umami Analytics to any MCP client - Claude Desktop, VS Code, Cursor, Windsurf, Zed, Smithery, and more.

Remote serverstreamable-http

What is the umami-mcp-server MCP Server?

umami-mcp-server is an MCP project maintained in the macawls/umami-mcp-server repository. The maintainer describes its purpose as “Connect your Umami Analytics to any MCP client - Claude Desktop, VS Code, Cursor, Windsurf, Zed, Smithery, and more”. Read the project documentation for the complete scope.

Hosted connection

The maintainer’s configuration uses https://umami-mcp.macawls.dev/mcp. It declares streamable-http transport. Check the project’s account and authentication instructions when adding the endpoint to your client.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_websitesList all websites (call this first to get website IDs)
get_statsAggregated statistics — pageviews, visitors, bounces, total time
get_pageviewsPageview and session counts grouped by time unit
get_metricsBreakdown by page, referrer, browser, OS, device, country, etc.
get_activeCurrent active visitor count in real-time
get_sessionsList individual visitor sessions, with total count — the sessions session replay records
get_session_statsAggregated session totals — pageviews, visitors, visits, countries, events
get_session_activityOrdered pageview/event timeline for a single session

How to install the umami-mcp-server MCP Server

{
  "mcpServers": {
    "umami": {
      "type": "http",
      "url": "https://umami-mcp.macawls.dev/mcp",
      "headersHelper": "echo X-Umami-Host: https://your-instance.com && echo X-Umami-Username: admin && echo X-Umami-Password: pass"
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.