MCP.so
Sign In

Umami Analytics MCP Server

@MCP-Mirror

About Umami Analytics MCP Server

Mirror of

Basic information

Category

Data & Analytics

License

MIT license

Runtime

python

Transports

stdio

Publisher

MCP-Mirror

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"
      }
    }
  }
}

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.

FAQ from Umami Analytics MCP Server

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.

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).

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.

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