Summary

Matomo web analytics: visits, page and entry-page reports, referrers, countries and devices, goal conversions and live visitor detail. Reporting API on Matomo Cloud or your own instance, token_auth.

Guided setup

Connect Matomo to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Matomo in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

Set up Matomo free I already have an account

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Matomo

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Matomo · live via MCP

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Matomo, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Matomo + Gemini

Matomo web analytics: visits, page and entry-page reports, referrers, countries and devices, goal conversions and live visitor detail. Reporting API on Matomo Cloud or your own instance, token_auth.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

MATOMO_URL, MATOMO_TOKEN

Step 1 — Get credentials

Getting a token

Sign in to Matomo and open Administration → Personal → Security → Auth tokens, then Create new token.
Leave 'Only allow secure requests' unticked only if you must — with it ticked, Matomo 4+ requires the token in a POST body rather than a query parameter. This adapter sends it as a query parameter (GET), which is Matomo's classic Reporting API shape and what the majority of installs accept.
Set MATOMO_URL to your Matomo root (no trailing slash, no /index.php) and MATOMO_TOKEN to the token.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
Save the file and restart gemini.
Run /mcp inside the Gemini CLI — Matomo should be listed as available.
Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID to the tools array of your request with the same X-API-Key header.

Available tools

Tool	What it does
`matomo_get_version`	Read the Matomo version of this instance
`matomo_list_sites`	List the sites this token can report on, with their id, name, main URL, timezone and currency
`matomo_get_visits_summary`	Read the headline numbers for a period: visits, unique visitors, actions, bounce rate, average visit duration and actions per visit
`matomo_get_page_urls`	Read the page report: which URLs were viewed, how often, their average time on page, bounce rate and exit rate
`matomo_get_entry_pages`	Read which pages visitors arrived on, with entries, bounce rate and the visits that followed — the landing-page view, not the pageview vie
`matomo_get_referrers`	Read where the traffic came from: search engines, websites, social networks, campaigns and direct entry, with visits and actions for each
`matomo_get_countries`	Read the visits broken down by country, with visit counts, actions and bounce rate — the geography of the audience
`matomo_get_device_types`	Read the visits broken down by device type — desktop, smartphone, tablet — with visits, actions and bounce rate
`matomo_get_goals`	Read goal conversions for a period: conversions, conversion rate and revenue, overall or for one goal
`matomo_get_last_visits`	Read individual recent visits with their referrer, country, device, and the pages each one viewed in order

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.

Next steps

Was this guide helpful?

Connect Matomo to Gemini CLI via MCP: Visits

Connect Matomo to Gemini in 2 minutes

Example prompts for Matomo

Matomo + Gemini

Prerequisites

Step 1 — Get credentials

Step 2 — Install the adapter

Step 3 — Add the connector in Gemini

Available tools

FAQ

Next steps

Connect Matomo to Gemini in 2 minutes

Related guides

Connect Matomo to Microsoft Copilot via MCP

Connect Matomo to Meta Muse via MCP: Analytics

Connect Matomo to ChatGPT via MCP: Web Analytics

Connect Matomo to Claude via MCP: Visits and Pages

Connect Matomo to Cursor via MCP: Page Reports

Matomo MCP Server: Visits, Pages and Conversions