Matomo JS MCP Server

What is Matomo JS?

Matomo JS is a Model Context Protocol (MCP) server that bridges AI agents (like large language models) with Matomo Analytics. It exposes Matomo Reporting API functionalities as MCP tools, enabling AI-driven data access. The project is under active development.

How to use Matomo JS?

Install the @mj-kiwi/matomo-mcp-server package (npm/yarn/pnpm) and configure it via environment variables to connect to your Matomo instance. The server provides MCP tools for the modules currently implemented (SitesManager, TagManager, Tour, UserId) and can be integrated into AI agent workflows.

Key features of Matomo JS

• Implements the Model Context Protocol specification
• Provides AI agents with direct access to Matomo data
• Easy configuration via environment variables
• Modular design mirroring the Matomo API structure
• Currently implements 4 of 47 API modules (8.5%)
• Part of a TypeScript Nx monorepo with tree-shakable design

Use cases of Matomo JS

• AI assistants querying site analytics data on demand
• Automated reporting using natural language interactions
• Integrating Matomo metrics into chatbot or copilot experiences
• Enabling non-technical users to retrieve analytics via conversation