Google Analytics MCP

Lokaler MCP-Server für Google Analytics 4. Kapselt die GA4 Data API in Tools, die auf SEO- und Paid-Reporting ausgerichtet sind.

Tools

Einrichtung

git clone https://github.com/ZLeventer/google-analytics-mcp-server.git
cd google-analytics-mcp-server
npm install
npm run build

Anmeldedaten

Kopieren Sie .env.example nach .env und füllen Sie die folgenden Felder aus:

• GA4_PROPERTY_ID — numerische Property-ID aus GA4 Admin → Property-Einstellungen (z. B. 123456789). Nicht die Measurement-ID (G-XXXXXXX).

• GOOGLE_APPLICATION_CREDENTIALS — absoluter Pfad zur JSON-Schlüsseldatei des Dienstkontos.

Dienstkonto erstellen

1. Gehen Sie zu console.cloud.google.com → Projekt auswählen/erstellen

2. APIs & Dienste → Bibliothek → Google Analytics Data API aktivieren

3. IAM & Verwaltung → Dienstkonten → Dienstkonto erstellen (nennen Sie es ga4-mcp oder ähnlich)

4. Beim erstellten Konto → Schlüssel → Schlüssel hinzufügen → Neuen Schlüssel erstellen → JSON → herunterladen

5. Speichern Sie das JSON als service-account.json in diesem Verzeichnis (bereits in .gitignore enthalten)

6. Klicken Sie in GA4 → Admin → Property-Zugriffsverwaltung auf + → fügen Sie die E-Mail-Adresse des Dienstkontos ein (ga4-mcp@project-id.iam.gserviceaccount.com) → weisen Sie die Rolle Betrachter zu

Das Google SDK liest GOOGLE_APPLICATION_CREDENTIALS automatisch ein — es sind keine Codeänderungen erforderlich.

In Claude Code installieren

claude mcp add google-analytics \
  --env-file "/absolute/path/to/google-analytics-mcp-server/.env" \
  -- node "/absolute/path/to/google-analytics-mcp-server/dist/index.js"

Oder manuell zu ~/.claude.json hinzufügen:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/google-analytics-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/google-analytics-mcp-server/service-account.json"
      }
    }
  }
}

Starten Sie Claude Code nach der Installation neu.

Datumsformate

Alle Datumsargumente akzeptieren GA4-Formate:

• YYYY-MM-DD (z. B. 2026-04-01)

• NdaysAgo (z. B. 28daysAgo, 90daysAgo)

• yesterday, today

Standardwerte: 28daysAgo → yesterday.

Überprüfung

Nachdem die Anmeldedaten hinterlegt sind:

node -e '
  import("./dist/tools/reports.js").then(m =>
    m.channelPerformance({ start_date: "7daysAgo", end_date: "yesterday", limit: 10 })
  ).then(r => console.log(JSON.stringify(r, null, 2)))
'

Wenn dies Zeilen zurückgibt, funktioniert alles. Erwartete Fehler:

• GA4_PROPERTY_ID is not set — prüfen Sie .env

• PERMISSION_DENIED — dem Dienstkonto wurde keine Betrachter-Rolle für die Property zugewiesen

• 403 Google Analytics Data API has not been used — aktivieren Sie die API im GCP-Projekt

Roadmap

• [ ] Admin-API-Tools (Auflistung benutzerdefinierter Dimensionen, Conversion-Ereignisse, Zielgruppen), sobald benötigt

• [ ] Search Console MCP als ergänzender Server für Rankings / Impressionen / CTR-Daten (ergänzt diesen Server)

• [ ] Kopplung mit Demandbase MCP, um GA4-Traffic mit Firmendaten (Account-basierte Attribution) zu verknüpfen