Google Analytics MCP server

Google Analytics MCP Server je experimentální lokální MCP server pro práci s Google Analytics. Zpřístupňuje účty, property a reporty z Google Analytics přes MCP klienta a hodí se hlavně pro dotazy nad GA4 daty z AI nástrojů.

Podle repozitáře server pracuje nad Google Analytics Admin API a Google Analytics Data API a nabízí hlavně tyto nástroje:

• get_account_summaries pro přehled dostupných účtů a property
• get_property_details pro detail konkrétní property
• list_google_ads_links pro vazby mezi property a Google Ads
• run_report pro standardní reporty nad daty Google Analytics
• run_realtime_report pro realtime reporty
• get_custom_dimensions_and_metrics pro přehled vlastních dimenzí a metrik

Pro zprovoznění je podle README potřeba:

• Python prostředí a pipx
• zapnuté API Google Analytics Admin API
• zapnuté API Google Analytics Data API
• Application Default Credentials pro účet, který má přístup k příslušným Google Analytics účtům nebo property
• scope https://www.googleapis.com/auth/analytics.readonly

Pro autentizaci spouštím gcloud příkaz na hostitelském počítači, ne uvnitř Dockeru. Vygenerovaný soubor s credentials pak přenesu do Dockeru a v kontejneru použiji cestu, kam byl zkopírován.

Na hostitelském počítači se credentials ukládají do ~/.config/gcloud/application_default_credentials.json.

Tady je příkaz, který používám:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

README používá jako příklad spuštění přes pipx a napojení do Gemini CLI nebo Gemini Code Assist.

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Pokud běží server v Dockeru, GOOGLE_APPLICATION_CREDENTIALS musí ukazovat na cestu k přenesenému souboru uvnitř kontejneru.

• GitHub: googleanalytics/google-analytics-mcp
• PyPI: analytics-mcp
• Google Analytics Admin API
• Google Analytics Data API