Gives Claude access to Umami website analytics for user behavior analysis and site performance tracking.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add umami --env UMAMI_API_URL='<UMAMI_API_URL>' --env UMAMI_PASSWORD='<UMAMI_PASSWORD>' --env UMAMI_TEAM_ID='<UMAMI_TEAM_ID>' --env UMAMI_USERNAME='<UMAMI_USERNAME>' -- uv --directory /path/to/analytics_service run analytics-service~/.codex/config.toml
[mcp_servers.umami]
command = "uv"
args = ["--directory", "/path/to/analytics_service", "run", "analytics-service"]
env = { UMAMI_API_URL = "<UMAMI_API_URL>", UMAMI_PASSWORD = "<UMAMI_PASSWORD>", UMAMI_TEAM_ID = "<UMAMI_TEAM_ID>", UMAMI_USERNAME = "<UMAMI_USERNAME>" }
# codex mcp add umami --env UMAMI_API_URL='<UMAMI_API_URL>' --env UMAMI_PASSWORD='<UMAMI_PASSWORD>' --env UMAMI_TEAM_ID='<UMAMI_TEAM_ID>' --env UMAMI_USERNAME='<UMAMI_USERNAME>' -- uv --directory /path/to/analytics_service run analytics-service~/.cursor/mcp.json
{
"mcpServers": {
"umami": {
"command": "uv",
"args": [
"--directory",
"/path/to/analytics_service",
"run",
"analytics-service"
],
"env": {
"UMAMI_API_URL": "<UMAMI_API_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_TEAM_ID": "<UMAMI_TEAM_ID>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"umami": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"/path/to/analytics_service",
"run",
"analytics-service"
],
"env": {
"UMAMI_API_URL": "<UMAMI_API_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_TEAM_ID": "<UMAMI_TEAM_ID>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"umami": {
"command": "uv",
"args": [
"--directory",
"/path/to/analytics_service",
"run",
"analytics-service"
],
"env": {
"UMAMI_API_URL": "<UMAMI_API_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_TEAM_ID": "<UMAMI_TEAM_ID>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"umami": {
"command": "uv",
"args": [
"--directory",
"/path/to/analytics_service",
"run",
"analytics-service"
],
"env": {
"UMAMI_API_URL": "<UMAMI_API_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_TEAM_ID": "<UMAMI_TEAM_ID>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"umami": {
"command": "uv",
"args": [
"--directory",
"/path/to/analytics_service",
"run",
"analytics-service"
],
"env": {
"UMAMI_API_URL": "<UMAMI_API_URL>",
"UMAMI_PASSWORD": "<UMAMI_PASSWORD>",
"UMAMI_TEAM_ID": "<UMAMI_TEAM_ID>",
"UMAMI_USERNAME": "<UMAMI_USERNAME>"
}
}
}
}Environment variables
UMAMI_API_URLUMAMI_PASSWORDUMAMI_TEAM_IDUMAMI_USERNAME
Replace the placeholders with your own credentials and keep them out of version control.