The MCP Server for Matomo lets you connect your Matomo analytics data to AI tools and large language models (LLMs) like ChatGPT, Claude, or custom AI assistants.
Instead of digging through reports, you can simply ask questions in plain English and get answers based on your real analytics data.
This plugin acts as a bridge between Matomo and AI tools. Once installed, it allows AI assistants to:
- Access your Matomo data
- Answer questions about your website performance
- Generate insights, summaries, and reports automatically
Think of it as giving your analytics a natural language interface.
Here are a few examples of what you can do:
- “What were my top traffic sources last week?”
- “Which campaigns drove the most conversions?”
- “How is mobile traffic trending this month?”
- Weekly or monthly summaries
- Marketing performance overviews
- Executive-ready insights without manual work
- Connect Matomo to internal AI tools
- Power dashboards with AI-generated insights
- Enable teams to explore data without needing analytics expertise
- Save time – no more manual report building
- Make data accessible – anyone can ask questions, no training needed
- Unlock AI use cases – bring your analytics into modern AI workflows
- Install the plugin in Matomo.
- Activate McpServer in Administration -> Plugins.
- Enable MCP in Administration -> System -> General Settings -> McpServer.
- Configure your MCP client with the endpoint and one of these authentication methods:
- OAuth2, if your MCP client supports it and the Matomo
OAuth2plugin is installed and enabled, with an OAuth2 client configured there. - A Matomo
token_authused as a Bearer token otherwise.
- OAuth2, if your MCP client supports it and the Matomo
For the recommended end-user setup flow, use the in-product connect guide at Administration -> Platform -> MCP Server.
- MCP access is disabled by default.
- The plugin uses Matomo authentication, including OAuth2 when the Matomo
OAuth2plugin is installed and enabled and an OAuth2 client is configured for the MCP client, ortoken_authBearer tokens otherwise. - Data access is limited to the same sites and reports the Matomo user can already access.
- If features such as the Visitor Log are available to that user, MCP clients may access the same underlying data scope.
The FAQ includes additional technical documentation for endpoint details, configuration, MCP enablement behavior, supported capabilities, and troubleshooting.
- Issues: https://github.com/matomo-org/plugin-McpServer/issues
- Forum: https://forum.matomo.org
- Source: https://github.com/matomo-org/plugin-McpServer
GPL v3 or later