umami-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UMAMI_URL | Yes | Your Umami instance URL (e.g. https://analytics.example.com) | |
| UMAMI_API_KEY | No | API key from Umami Cloud dashboard | |
| UMAMI_PASSWORD | No | Login password for self-hosted instances | |
| UMAMI_USERNAME | No | Login username for self-hosted instances |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_websitesB | List all websites tracked in Umami |
| get_websiteA | Get details of a specific website by ID |
| create_websiteC | Create a new website to track in Umami |
| update_websiteC | Update an existing website's configuration |
| delete_websiteB | Delete a website from Umami |
| get_active_visitorsB | Get the number of currently active visitors on a website |
| reset_websiteB | Reset a website by removing all its analytics data (irreversible) |
| transfer_websiteB | Transfer website ownership to another user |
| get_website_reportsB | Get all reports associated with a specific website |
| get_statsB | Get summary statistics for a website (pageviews, visitors, visits, bounces, totaltime) |
| get_pageviewsC | Get pageview and session counts over time for a website |
| get_metricsC | Get aggregated metrics for a website (e.g. top pages, browsers, countries, devices, OS, events) |
| get_eventsC | Get event data for a website over time |
| get_sessionsC | Get session data for a website |
| get_daterangeB | Get the date range of available data for a website |
| get_event_seriesC | Get event metrics over time (event series data) for a website |
| get_session_statsB | Get summarized session statistics for a website (total sessions, unique visitors, etc.) |
| get_sessions_weeklyC | Get weekly session data for a website |
| get_sessionC | Get details of a specific session |
| get_session_activityB | Get activity log for a specific session (pages visited, events fired) |
| get_session_propertiesC | Get custom properties attached to a specific session |
| get_session_data_propertiesA | Get session data property names and their data types for a website |
| get_session_data_valuesB | Get session data values (aggregated counts for session properties) for a website |
| send_eventB | Send a custom event or pageview to Umami (useful for server-side tracking) |
| get_event_valuesC | Get event or session property values for a website |
| get_event_data_eventsB | Get event data events (custom event names and counts) for a website |
| get_event_data_fieldsA | Get event data fields (property keys and their data types) for a website |
| get_event_data_valuesA | Get event data values (aggregated counts for a specific property) for a website |
| get_event_data_statsB | Get event data statistics (summary counts) for a website |
| batch_eventsA | Send multiple events or pageviews in a single batch request |
| list_reportsC | List all saved reports |
| get_reportB | Get details of a specific saved report |
| create_reportC | Create and save a new report |
| update_reportC | Update an existing saved report |
| delete_reportB | Delete a saved report |
| run_reportB | Execute a report by type and get results (funnel, retention, utm, goals, insights, revenue, journey, attribution) |
| list_usersC | List all users (admin only) |
| create_userB | Create a new user (admin only) |
| get_userA | Get details of a specific user (admin only) |
| update_userB | Update a user's username, password, or role (admin only) |
| delete_userB | Delete a user (admin only) |
| get_user_websitesB | Get the list of websites a user has access to (admin only) |
| get_user_usageC | Get usage statistics for a specific user (admin only) |
| get_user_teamsB | Get the list of teams a user belongs to (admin only) |
| list_teamsC | List all teams |
| create_teamC | Create a new team |
| get_teamA | Get details of a specific team |
| update_teamB | Update a team's name |
| delete_teamB | Delete a team |
| join_teamB | Join a team using an access code |
| list_team_usersC | List all members of a team |
| add_team_userB | Add a user to a team |
| update_team_userB | Update a team member's role |
| get_team_userA | Get details of a specific team member |
| remove_team_userB | Remove a user from a team |
| list_team_websitesB | List all websites that belong to a team |
| add_team_websiteC | Add a website to a team |
| remove_team_websiteB | Remove a website from a team |
| get_realtimeA | Get real-time data for a website (last 30 minutes). Returns current visitors, active URLs, referrers, countries, and events. |
| get_meA | Get the currently authenticated user's profile information |
| get_my_websitesA | Get the list of websites belonging to the current user |
| get_my_teamsB | Get the list of teams the current user belongs to |
| update_my_passwordB | Update the current user's password |
| verify_authB | Verify the current authentication token is valid |
| get_shareB | Get shared website data by share ID (public access, no auth required for the share itself) |
| heartbeatA | Check if the Umami server is running and healthy |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| site_overview | Comprehensive overview of a website's analytics — fetches stats, pageviews, top pages, and active visitors |
| traffic_compare | Compare traffic between two date ranges to identify trends |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| websites | List of all websites tracked in Umami |
| account | Current authenticated Umami user info |
Latest Blog Posts
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