matious89pl/umami-analytics-mcp

This project connects Umami, a website analytics tool that tracks visitor traffic, to AI assistants like Claude through something called the Model Context Protocol, or MCP. MCP is a standard way for AI chat tools to plug into outside services and pull in live data or perform actions, rather than only knowing what was in their training. With this connected, you can ask an AI assistant questions about your website's traffic, generate reports, and even manage your Umami account, all through normal conversation instead of clicking around a dashboard. It works with both Umami Cloud, the hosted version, and self-hosted Umami installations that you run yourself. Getting started needs no installation at all: you point your AI client at a single command, supply an API key or login details as environment variables, which are just settings kept outside the code, and it connects. There is also an option to deploy it yourself on Vercel, a hosting platform, or run it in a Docker container, a way of packaging software to run consistently anywhere. Security is a major focus of this project. By default, the assistant can only read data, not change anything: viewing statistics, generating reports on things like funnels, user retention, and revenue, and browsing sessions. If you want the AI to also create or update things, or manage self-hosted user accounts, you have to explicitly turn those abilities on through separate settings. Anything destructive, like deleting a website or resetting data, needs an extra opt-in on top of that. Login secrets are kept only in environment variables and are actively scrubbed from logs and error messages so they never leak out accidentally. Overall this is a tool for developers and site owners who already use Umami and want to interact with their analytics data through an AI assistant rather than a traditional dashboard. It requires some comfort with environment variables and, for self-hosting, basic server or Docker knowledge. The project is open source under the MIT license.