umami-mcp-server MCP Server

A Model Context Protocol (MCP) server that enhances Claude's capabilities by providing access to website analytics data from Umami. This server allows Claude to analyze user behavior, track website…

Local serverstdio

What is the umami-mcp-server MCP Server?

umami-mcp-server is an MCP project maintained in the jakeyshakey/umami_mcp_server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that enhances Claude's capabilities by providing access to website analytics data from Umami. This server allows Claude to analyze…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares UMAMI_API_URL, UMAMI_USERNAME, UMAMI_PASSWORD, UMAMI_TEAM_ID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

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_websitesRetrieve a list of websites and their IDs in your Umami account
get_website_statsGet key metrics like pageviews, visitors, bounce rate for a website
get_website_metricsAnalyze specific metrics like URLs, referrers, browsers, countries
get_pageview_seriesGet time-series pageview data with customizable intervals
get_active_visitorsMonitor current number of active visitors on a website
get_session_idsRetrieve session IDs for specific events or time periods
get_tracking_dataGet detailed activity data for a specific session ID
get_docsPerform semantic search on many user journeys, returning the most relevant chunks for a given question
get_screenshotCapture visual snapshots of webpages
get_htmlRetrieve and analyze webpage HTML source code

How to install the umami-mcp-server MCP Server

{
  "mcpServers": {
    "analytics_service": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/analytics_service",
        "run",
        "analytics-service"
      ],
      "env": {
        "UMAMI_API_URL": "https://example.com",
        "UMAMI_USERNAME": "yourUmamiUsername",
        "UMAMI_PASSWORD": "YOUR_UMAMI_PASSWORD",
        "UMAMI_TEAM_ID": "yourUmamiTeamId"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
UMAMI_API_URLDeclared in the maintainer’s client configuration.Check documentation
UMAMI_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
UMAMI_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
UMAMI_TEAM_IDDeclared in the maintainer’s client configuration.Check documentation