🤖 Piwik PRO MCP Server (beta)

A Model Context Protocol (MCP) server built with the official MCP Python SDK that lets you control Piwik PRO Analytics resources.

🎇 Features

💬 Query API — Have a conversation with your analytics data

Turn questions into insights. The Query API lets you explore your analytics data using natural language. Ask about visitors, page views, conversions, and more without navigating complex dashboards or building reports manually.

• Run flexible queries with custom date ranges and filters
• Discover available dimensions and metrics
• Get answers to analytics questions in seconds

📊 Manage Analytics

Keep your analytics setup organized without leaving your the conversation with your AI assistant:

• Annotations — Add notes to mark important events, campaigns, or changes
• Goals — Set up and manage conversion tracking
• Custom dimensions — Extend your tracking with custom data points

🏷️ Control Tag Manager

Manage your tracking setup without touching your website code:

• Tags — Create and configure tracking tags
• Triggers — Define when and where tags fire
• Variables — Store and reuse dynamic values
• Version control — Publish changes when you’re ready

🎯 Build audiences with Data Activation (DA)

Build and manage your audience segments:

• Create targeted audiences based on user behavior
• Update segmentation rules in real time

⚙️ Configuration and settings

Fine-tune your Piwik PRO setup:

• App management — Organize your sites and apps
• Tracker settings — Configure tracking behavior globally or for each app
• Container settings — Access installation code and container configuration

🚀 Quickstart

Go to your account’s API credentials page: https://ACCOUNT.piwik.pro/profile/api-credentials, then generate new credentials.

You will need these three variables for the MCP configuration:

• PIWIK_PRO_HOST - Your piwik host, ACCOUNT.piwik.pro
• PIWIK_PRO_CLIENT_ID - Client ID
• PIWIK_PRO_CLIENT_SECRET - Client Secret

MCP Client configuration

All of these MCP clients use a JSON file to store the MCP configuration. The file name and location vary by client.

• Claude Desktop

  • Go to Settings -> Developer -> Edit Configto open the folder containing claude_desktop_config.json.
  • Apply one of the snippets from below.
  • Restart the application.

• Cursor - The official documentation

• Claude Code - The official documentation

To use Piwik PRO MCP server, you need to install uv or docker.

Copy the configuration of your preferred option and enter the required environment variables.

Option #1 - UV

If you don’t have uv, check the