Skip to main content
Glama
zgeoff

@zgeoff/umami-mcp

by zgeoff

@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:

Variable

Mode

Notes

UMAMI_API_KEY

Umami Cloud

required for Cloud; wins when both modes are set

UMAMI_USERNAME + UMAMI_PASSWORD

self-hosted

rejected against Umami Cloud

UMAMI_API_BASE

both

API root; defaults to https://api.umami.is/v1. Self-hosted: https://your-umami.example/api

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

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    F
    maintenance
    Enables AI assistants to interact with Umami Analytics for both Cloud and self-hosted instances. It provides tools to retrieve website statistics, visitor metrics, pageview trends, and real-time active user counts.
    5
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Read-only MCP server for Umami analytics. It talks to the Umami REST API directly over HTTP, supporting self-hosted and cloud setups.
    8
    17
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A read-only Model Context Protocol server for self-hosted Umami analytics. Enables querying website analytics data such as pageviews, visitors, and metrics through natural language.
    1
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zgeoff/umami-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server