MCP.so
Sign In

Umami Analytics MCP Server

@MCP-Mirror

Basic information

Category

Data & Analytics

License

MIT license

Transports

stdio

Author

MCP-Mirror

About Umami Analytics MCP Server

Mirror of

Umami Analytics MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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": "yourUmamiPassword",
        "UMAMI_TEAM_ID": "yourUmamiTeamId"
      }
    }
  }
}

Umami Analytics MCP Server tools

10

Retrieve a list of websites and their IDs in your Umami account

Get key metrics like pageviews, visitors, bounce rate for a website

Analyze specific metrics like URLs, referrers, browsers, countries

Get time-series pageview data with customizable intervals

Monitor current number of active visitors on a website

Retrieve session IDs for specific events or time periods

Get detailed activity data for a specific session ID

Perform semantic search on many user journeys, returning the most relevant chunks for a given question

Capture visual snapshots of webpages

Retrieve and analyze webpage HTML source code

Overview

What is Umami Analytics MCP Server?

A Model Context Protocol (MCP) server that enhances Claude with access to website analytics data from Umami. It enables Claude to analyze user behavior, track website performance, and generate data-driven insights.

How to use Umami Analytics MCP Server?

Install uv, then add the MCP server configuration to your Claude Desktop config file (claude_desktop_config.json) with the Umami API URL, username, password, and team ID. When you open Claude Desktop, the server connects automatically. Use the built-in "Create Dashboard Prompt" or interact via natural language; Claude will choose the appropriate tools.

Key features of Umami Analytics MCP Server

  • Provides 10 analytical tools for Umami data.
  • Offers semantic search on user journey chunks.
  • Captures webpage screenshots and HTML via Crawl4AI.
  • Supports custom prompt creation for repeatable workflows.
  • Enables dashboard generation with guided prompts.

Use cases of Umami Analytics MCP Server

  • Analyze user journeys and behavior patterns.
  • Monitor real-time active visitors on a website.
  • Generate performance dashboards and visualizations.
  • Identify user pain points through semantic journey search.
  • Improve site performance with contextual webpage context.

Frequently asked questions

1

What are the prerequisites to run the server?

You need to install `uv` and have Umami account credentials: API URL, username, password, and team ID.

2

How do I configure the server in Claude Desktop?

Add a JSON entry under `mcpServers` in your `claude_desktop_config.json`, specifying `uv` as the command and the required environment variables (`UMAMI_API_URL`, `UMAMI_USERNAME`, `UMAMI_PASSWORD`, `UMAMI_TEAM_ID`).

3

Can I create my own prompts and workflows?

Yes, define a prompt structure in `list_prompts()` and implement its logic in `get_prompt()` within `src/analytics_service/server.py`.

4

How does the server handle large user journey data?

The `get_docs` tool chunks journey data, embeds them with a sentence transformer, and returns only the most relevant segments via semantic search, preventing context window overload.

Comments

More Data & Analytics MCP servers