Which integrations are available for this server?

Provides full-coverage integration for the Umami Analytics API v2, allowing users to manage websites, query analytics statistics and metrics, send custom tracking events, generate reports, and perform administrative tasks for users and teams.

umami-mcp

by mikusnuz

Overview Schema Related Servers Score Discussions

TypeScript

Remote

English | 한국어

umami-mcp

npm version License: MIT MCP Badge

Full-coverage Model Context Protocol (MCP) server for Umami Analytics API v2.

Unlike existing Umami MCP implementations (read-only, ≤5 tools), this server provides 66 tools, 2 resources, and 2 prompts covering the entire Umami API — websites CRUD, stats, sessions, events, event-data, session-data, reports, user management, teams, realtime, account, and more.

When to Use

Use this MCP when you need to:

"Show me website analytics for the last 7 days" — get stats, pageviews, and metrics with date filters
"Which pages got the most views this month?" — query aggregated metrics by URL
"Compare traffic between two date ranges" — use the traffic_compare prompt or get_stats with different ranges
"Set up a new website in Umami" — create and configure tracked websites
"Get real-time active visitors" — check active visitors and real-time data
"Export analytics report" — create, run, and retrieve reports (funnel, retention, UTM, goals, revenue, attribution)
"Track a custom event from the server" — send events or batch events programmatically
"Manage team access to analytics" — create teams, add users and websites to teams

Related MCP server: Umami MCP Server

Features

66 Tools — Full CRUD for websites, detailed analytics, session tracking, event sending & event-data queries, report management (including attribution), user/team administration, team-website management, account management, batch events, and realtime monitoring
2 Resources — Quick access to website list and account info
2 Prompts — Pre-built analytics workflows (site overview, traffic comparison)
Dual Auth — Self-hosted (username/password → JWT) and Umami Cloud (API key)
Lazy Config — Server starts without credentials; auth is checked on first API call
Zero Dependencies — Uses native fetch, no external HTTP libraries

Installation

npm install -g @mikusnuz/umami-mcp

Or use directly with npx:

npx @mikusnuz/umami-mcp

Configuration

Environment Variables

Variable	Required	Description
`UMAMI_URL`	Yes	Your Umami instance URL (e.g. `https://analytics.example.com`)
`UMAMI_USERNAME`	For self-hosted	Login username
`UMAMI_PASSWORD`	For self-hosted	Login password
`UMAMI_API_KEY`	For Umami Cloud	API key from Umami Cloud dashboard

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "umami": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/umami-mcp"],
      "env": {
        "UMAMI_URL": "https://analytics.example.com",
        "UMAMI_USERNAME": "admin",
        "UMAMI_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add umami -- npx -y @mikusnuz/umami-mcp

# Set environment variables
export UMAMI_URL="https://analytics.example.com"
export UMAMI_USERNAME="admin"
export UMAMI_PASSWORD="your-password"

Tools (66)

Websites (9)

Tool	Description
`list_websites`	List all tracked websites
`get_website`	Get website details by ID
`create_website`	Create a new website
`update_website`	Update website configuration
`delete_website`	Delete a website
`get_active_visitors`	Get current active visitor count
`reset_website`	Reset all analytics data for a website
`transfer_website`	Transfer website ownership to another user
`get_website_reports`	Get all reports for a website

Stats & Analytics (9)

Tool	Description
`get_stats`	Summary statistics (pageviews, visitors, bounce rate, etc.)
`get_pageviews`	Pageview/session counts over time
`get_metrics`	Aggregated metrics (top pages, browsers, countries, etc.)
`get_events`	Event data over time
`get_sessions`	Session listing with filters
`get_daterange`	Available data date range
`get_event_series`	Event metrics over time (event series)
`get_session_stats`	Summarized session statistics
`get_sessions_weekly`	Weekly session data

Sessions (5)

Tool	Description
`get_session`	Session details
`get_session_activity`	Session activity log
`get_session_properties`	Session custom properties
`get_session_data_properties`	Session data property names and types
`get_session_data_values`	Session data aggregated values

Events (7)

Tool	Description
`send_event`	Send custom events/pageviews (server-side tracking)
`get_event_values`	Event/session property values
`get_event_data_events`	Event data events (custom event names and counts)
`get_event_data_fields`	Event data fields (property keys and types)
`get_event_data_values`	Event data values (aggregated counts for a property)
`get_event_data_stats`	Event data statistics summary
`batch_events`	Send multiple events in a single batch request

Reports (6)

Tool	Description
`list_reports`	List saved reports
`get_report`	Get report details
`create_report`	Create and save a report
`update_report`	Update an existing report
`delete_report`	Delete a saved report
`run_report`	Execute a report (funnel, retention, utm, goals, insights, revenue, journey, attribution)

Users (8, admin only)

Tool	Description
`list_users`	List all users
`create_user`	Create a new user (username, password, role)
`get_user`	Get user details
`update_user`	Update user (username, password, or role)
`delete_user`	Delete a user
`get_user_websites`	List websites a user has access to
`get_user_usage`	Get usage statistics for a user
`get_user_teams`	List teams a user belongs to

Teams (14)

Tool	Description
`list_teams`	List all teams
`create_team`	Create a new team
`get_team`	Get team details
`update_team`	Update team name
`delete_team`	Delete a team
`join_team`	Join a team using an access code
`list_team_users`	List team members
`get_team_user`	Get details of a specific team member
`add_team_user`	Add a user to a team
`update_team_user`	Update a team member's role
`remove_team_user`	Remove a user from a team
`list_team_websites`	List websites belonging to a team
`add_team_website`	Add a website to a team
`remove_team_website`	Remove a website from a team

Account (7)

Tool	Description
`get_me`	Get current authenticated user profile
`get_my_websites`	List current user's websites
`get_my_teams`	List current user's teams
`update_my_password`	Update current user's password
`verify_auth`	Verify authentication token is valid
`get_share`	Get shared website data by share ID
`heartbeat`	Check if Umami server is healthy

Realtime (1)

Tool	Description
`get_realtime`	Real-time data for last 30 minutes (visitors, URLs, referrers, countries, events)

Resources (2)

Resource	URI	Description
Websites	`umami://websites`	All tracked websites
Account	`umami://me`	Current user info

Prompts (2)

Prompt	Description
`site_overview`	Comprehensive site analysis (stats + pageviews + top metrics + active visitors)
`traffic_compare`	Compare traffic between two date ranges

Usage Examples

Get website statistics

Use get_stats to show me the last 7 days of analytics for my main website.

Compare periods

Use the traffic_compare prompt to compare last week vs this week for website abc-123.

Send server-side event

Use send_event to track a "signup" event on my website with data { plan: "pro" }.

Batch multiple events

Use batch_events to send 3 pageview events for different pages on my website.

Check server health

Use heartbeat to check if the Umami server is running.

Development

git clone https://github.com/mikusnuz/umami-mcp.git
cd umami-mcp
npm install
npm run build

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

View all tools

Related MCP Servers

Umami MCP Server
Marketing Search
Alurith
A
license
C
quality
B
maintenance
MCP server exposing Umami analytics (Cloud + self-hosted)
Updated 10 days ago (2026-08-06 17:36 UTC)
5
MIT
Umami MCP Server
Monitoring Observability
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.
Updated 4 months ago (2026-04-30 02:05 UTC)
8
22
MIT
umami-mcp-server
Monitoring Observability
frontedu
A
license
-
quality
B
maintenance
MCP server for Umami Analytics that provides read-only tools to query website stats, events, sessions, reports, and more, enabling natural language analytics queries.
Updated a month ago (2026-07-18 15:19 UTC)
13
2
MIT
umami-analytics-mcp
Monitoring Observability
matious89pl
A
license
A
quality
B
maintenance
A security-first MCP server for Umami analytics (Cloud and self-hosted v3) enabling analytics, reporting, and administration with least privilege and credential-safe design.
Updated 2 months ago (2026-06-30 20:53 UTC)
32
22
MIT

View all related MCP servers

Related MCP Connectors

mcp
MCP (Model Context Protocol) server for Appwrite
Supabase
MCP server for interacting with the Supabase platform
anythingmcp
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/mikusnuz/umami-mcp'

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

umami-mcp

When to Use

Features

Installation

Configuration

Environment Variables

Claude Desktop

Claude Code

Tools (66)

Websites (9)

Stats & Analytics (9)

Sessions (5)

Events (7)

Reports (6)

Users (8, admin only)

Teams (14)

Account (7)

Realtime (1)

Resources (2)

Prompts (2)

Usage Examples

Get website statistics

Compare periods

Send server-side event

Batch multiple events

Check server health

Development

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Umami MCP Server

Umami MCP Server

umami-mcp-server

umami-analytics-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API