umami-mcp
CommunityMCP server by Asif2BD · updated · ★ 1 · 394 downloads a week
Query Umami Analytics v3 — stats, funnels, retention, attribution, UTM. Read-only by default. umami-mcp is a community project by Asif2BD, not verified by a company domain.
Last commit 13 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
UMAMI_Environment variable | Required | Your Umami instance URL, e.g. https://analytics.example.com |
UMAMI_Environment variable | Optional | Umami username. Self-hosted Umami has no API keys, so a login is required. |
UMAMI_Environment variable, secret | Optional | Umami password. Prefer a dedicated, limited account over your admin login. |
UMAMI_Environment variable, secret | Optional | Umami Cloud API key, used instead of username and password. |
UMAMI_Environment variable | Optional | Permission tier: read (default), write, or admin. Tools above the tier are never registered. |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install umami-mcp
Built from the published package, never by AIclaude mcp add umami-mcp -e UMAMI_URL=YOUR_UMAMI_URL -- npx -y @asif2bd/umami-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "YOUR_UMAMI_URL"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "YOUR_UMAMI_URL"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "YOUR_UMAMI_URL"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add umami-mcp --env UMAMI_URL=YOUR_UMAMI_URL -- npx -y @asif2bd/umami-mcp{
"mcpServers": {
"umami-mcp": {
"command": "npx",
"args": [
"-y",
"@asif2bd/umami-mcp"
],
"env": {
"UMAMI_URL": "YOUR_UMAMI_URL"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add umami-mcp npx -y @asif2bd/umami-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the umami-mcp block.
Weekly newsletter
Like umami-mcp? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to umami-mcp
All alternatives →The Power BI Authoring MCP server lets an AI agent create and change Power BI semantic models.
Agent-Native Amplitude/Mixpanel - connect data sources, prompt for charts
Google Ads, Meta Ads, Google Analytics (GA4) & Search Console MCP server by Ryze AI
A Model Context Protocol (MCP) server that provides chat functionality with Cube's AI agent for analytics and data exploration
Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.
MCP gateway for AI models (OpenAI, Grok, DeepSeek, Claude and other function-calling LLMs) and for web pages and apps: one authenticated, observable endpoint in front of your MCP servers with routing, scopes, rate limits and metrics.
umami-mcp: common questions
How do I install umami-mcp?
In Claude Code run claude mcp add umami-mcp -e UMAMI_URL=YOUR_UMAMI_URL -- npx -y @asif2bd/umami-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is umami-mcp the official server?
umami-mcp is a community project by Asif2BD, not verified by a company domain.
Is umami-mcp free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is umami-mcp safe to use?
It scores 78 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to umami-mcp?
Similar MCP servers: Power BI Authoring MCP Server (Local), Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Cube Dev MCP Server.
Does umami-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
