Matomo MCP
Provides access to Matomo's Reporting API to retrieve website analytics, including traffic and engagement summaries, referrer breakdowns, page performance metrics, and goal conversions with revenue data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Matomo MCPShow me last month's top pages by page views"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Matomo MCP
Read website acquisition, content, conversion, and engagement analytics from Matomo's Reporting API.
Part of Pipeworx — an MCP gateway connecting AI agents to 1573+ live data sources.
Tools
matomo_visit_summary— aggregate traffic and engagementmatomo_referrer_breakdown— acquisition channels and sourcesmatomo_page_performance— page views, entrances, exits, and timematomo_goal_performance— conversions and revenue by goal
Related MCP server: Matomo MCP Server
Auth
Pass your Matomo installation URL as _baseUrl and a read-only auth token as _apiKey. Requests require HTTPS and send the token in a POST body. The pack is read-only.
Data sources
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"matomo": {
"url": "https://gateway.pipeworx.io/matomo/mcp"
}
}
}What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/matomo/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}Both URLs reach the same gateway and the same 1573+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Standalone (no gateway account)
This package also runs as a local stdio MCP server — no Pipeworx account, no gateway round-trip:
{
"mcpServers": {
"matomo": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-matomo"]
}
}
}Or run it directly to confirm it starts:
npx -y @pipeworx/mcp-matomoIt speaks MCP over stdin/stdout and answers initialize/tools/list/tools/call
for only this pack's tools — none of the shared meta-tools the gateway
connection above adds. Same source, same tools, no ask_pipeworx routing.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Matomo data" })The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only website analytics, AI referrals, crawlers, goals, revenue, and funnels.
Query site stats, realtime visitors, breakdowns and goals from Plausible Analytics.
Read-only access to your Nexly web analytics: traffic, pages, acquisition, events, and reports.
Read-only Yandex Metrika MCP. Query visits, sources, geo, devices and more in plain language.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI models to interact with Matomo analytics through a complete MCP server implementation. Provides tools for retrieving analytics data, managing sites, and generating reports with zero configuration setup.-
- FlicenseBqualityBmaintenanceEnables LLMs to directly query a Matomo analytics instance, execute reporting methods, fetch historical trends, report metadata, and dynamically generated chart images through typed MCP tools.6-
- AlicenseNot gradedqualityCmaintenanceExposes Umami analytics (Cloud or self-hosted) as read-only tools for querying website stats, pageviews, metrics, and active visitors.312 npmMIT
- FlicenseNot gradedqualityCmaintenanceRead-only access to Google Analytics 4 reporting data, including traffic overview, top pages, traffic sources, and conversion events, supporting custom report queries via MCP.-