Google-Ads-Konten und Keyword-Ideen abfragen

google-ads-mcp-server · MCP-Server von gomarble-ai · MCP-Server

MCP-Server für Google Ads · lesen · MIT

Führt Befehle ausWas der Baustein im Konto darf

Lokaler MCP-Server von GoMarble für die Google Ads API mit OAuth 2.0. Er listet Konten auf, führt GAQL-Abfragen aus und liefert Keyword-Ideen mit Metriken.

Eigenes Profil aus den Quellen des Servers, Stand 05.10.2026 · Beleg 7

Was der Server kann

  • Listet alle zugänglichen Google-Ads-Konten auf.
  • Führt beliebige GAQL-Abfragen für ein Konto aus, optional über ein Manager-Konto.
  • Erzeugt Keyword-Ideen mit Kennzahlen aus Keywords oder einer Seiten-URL.
  • Meldet sich beim ersten Aufruf per Browser über Google OAuth an und erneuert Tokens automatisch.
  • Speichert Tokens lokal in einer Datei.
  • Läuft per Standard über stdio, optional im HTTP-Modus mit `python3 server.py --http`.

Einsatz in Marketing und Vertrieb

Performance-Marketing
Du fragst, welche Kampagnen der letzten 30 Tage die höchsten Kosten je Conversion haben. Der Assistent formuliert eine GAQL-Abfrage und wertet das Ergebnis aus.
SEO
Du nennst eine Seiten-URL und bittest um Keyword-Ideen mit Suchvolumen. Der Server liefert sie aus dem Keyword Planner.

Einrichtung

  1. Ein Google-Cloud-Projekt anlegen, die Google Ads API aktivieren und OAuth-Zugangsdaten als Desktop-Anwendung erstellen.
  2. Im Google-Ads-Konto unter API Center einen Developer Token beantragen.
  3. Das Repository klonen, `pip install -r requirements.txt` ausführen und in `.env` `GOOGLE_ADS_DEVELOPER_TOKEN` und `GOOGLE_ADS_OAUTH_CONFIG_PATH` setzen.
  4. In der Claude-Desktop-Konfiguration den Python-Interpreter und den Pfad zu `server.py` eintragen, neu starten und beim ersten Aufruf im Browser anmelden.

Grenzen

  • Kampagnen anlegen oder ändern ist laut README nur als künftige Funktion in der Roadmap genannt.
  • Ein neuer Developer Token ist zunächst ein Test-Token mit eingeschränktem Funktionsumfang, die Freigabe dauert laut README meist 1 bis 3 Werktage.
  • Die README nennt Python 3.10 oder neuer als Voraussetzung.

Einordnung der Redaktion

Aufgaben: Anzeigen schalten, Auswerten & berichten. Für Marketing und Vertrieb gedacht.

Eigene Einordnung aus Name und Beschreibung des Anbieters, ohne technische Prüfung. Maßgeblich ist der Text des Anbieters darunter.

Beschreibung des Anbieters

This repo helps us to analyze googla ads performance data

Eckdaten

—: Angabe nicht belegt.

Maintainer
gomarble-ai
Repository-Lizenz
MIT
Letzter Repository-Commit

Commit innerhalb 90 Tagen

Dienstanbieter
Offizielle Dienstherkunft nicht belegt
Dienste
Google Ads
Bereiche
Marketing
Plattformen
—
Clients
Claude Desktop

Werkzeuge

list_accounts

Listet alle zugänglichen Google-Ads-Konten.

List all accessible accounts including nested sub-accounts. Angabe des Anbieters · Beleg 4
run_gaql

Führt GAQL-Abfragen mit `customer_id` und `query` aus.

Execute GAQL using the non-streaming search endpoint for consistent JSON parsing. Angabe des Anbieters · Beleg 4
run_keyword_planner

Erzeugt Keyword-Ideen mit Kennzahlen.

Generate keyword ideas using Google Ads KeywordPlanIdeaService. This tool allows you to generate keyword ideas based on seed keywords or a page URL.… Angabe des Anbieters · Beleg 4

Voraussetzungen

  • GOOGLE_ADS_DEVELOPER_TOKEN · Umgebungsvariable · erforderlich · Beleg 5
  • GOOGLE_ADS_OAUTH_CONFIG_PATH · Umgebungsvariable · erforderlich · Beleg 5
  • Python · Laufzeit · erforderlich · Beleg 6
2 Umgebungsvariablen laut Anbieter
  • PYTHONPATH · Umgebungsvariable · Beleg 5
  • GOOGLE_ADS_LOGIN_CUSTOMER_ID · Umgebungsvariable · Beleg 6

Installation

pip install -r requirements.txt

Rechte

Führt Befehle aus

Einordnung aus Werkzeugliste, Paketangaben und Paketinhalt, keine technische Prüfung · So entsteht die Ampel

  • 1 von 3 Werkzeugen kann Befehle ausführen, etwa run_keyword_planner.
  • Der Anbieter deklariert: lesen.

Lass löschende, sendende und ausführende Werkzeuge nur nach Bestätigung je Aktion laufen und verbinde zuerst ein Testkonto.

Ein Google-Ads-Developer-Token, OAuth-Zugangsdaten aus der Google Cloud und die Anmeldung mit einem Google-Konto, das Zugriff auf Google Ads hat. Die drei Werkzeuge lesen nur; die README beschreibt keine Schreibfunktionen.

Zugriffe laut Paketangaben
lesen
Authentifizierung
—
Transport
—
Technische Prüfung
Ungeprüft
Quellen (7)

Verbundenes