Umami MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UMAMI_API_KEY | No | API key for Umami Cloud or self-hosted with API key auth | |
| UMAMI_API_URL | No | The base URL of the Umami API (e.g., https://api.umami.is/v1 or https://umami.example.com/api) | |
| UMAMI_PASSWORD | No | Password for self-hosted Umami login | |
| UMAMI_USERNAME | No | Username for self-hosted Umami login | |
| UMAMI_DEFAULT_TIMEZONE | No | Default timezone used when a tool supports timezone and you omit it (e.g., Asia/Shanghai) | Asia/Shanghai |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| umami_pingA | Validate Umami configuration and authentication. Returns the auth mode, API base URL, instance URL, default timezone, and current user info. |
| umami_list_websitesA | List accessible Umami websites. Returns id, name, domain, and createdAt for each website. |
| umami_find_websiteA | Search Umami websites by name or domain using fuzzy matching. Useful before calling other analytics tools. |
| umami_get_statsA | Get summarized Umami stats for a website and time range. Returns pageviews, visitors, visits, bounces, totaltime, and comparison data. |
| umami_get_pageviewsA | Get pageview and session time series for a website. Supports time bucketing, timezone, period comparison, and shared filters. |
| umami_get_breakdownA | Get a metric breakdown for a website and time range. Use expanded=true for detailed metrics or expanded=false for x/y breakdown rows. |
| umami_get_activeA | Get the number of active visitors on a website during the last 5 minutes. |
| umami_get_events_seriesB | Get custom event counts for a website over time. Returns event name, timestamp, and count rows. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool serves a distinct purpose: searching, listing, validating, and retrieving various analytics metrics (active visitors, breakdown, events, pageviews, stats). No overlap or ambiguity.
All tool names follow a consistent 'umami_verb_noun' pattern (e.g., umami_find_website, umami_get_active). The pattern is uniform and predictable.
With 8 tools, the set is well-scoped for an analytics API. It covers essential query operations without being bloated or sparse.
The tool set provides comprehensive read-only access to Umami analytics: website listing/search, active visitors, pageviews, events, breakdowns, stats, and authentication validation. No obvious gaps for querying use cases.