Skip to main content
Glama
zgeoff

@zgeoff/umami-mcp

by zgeoff
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Umami MCP Server

    lukasschmit
    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

  • Umami MCP Server

    Mzaxd
    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
    6 npm
    MIT

  • Umami MCP

    upnorthmedia
    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

  • umami-mcp-server

    arttus
    A
    license
    A
    quality
    B
    maintenance
    Enables natural-language analytics against Umami, including traffic stats, time series, sessions, custom events, and filtered breakdowns, plus self-hosted admin CRUD for websites, users, and teams, and client onboarding.
    48
    12 npm
    MIT