Google Ads MCP Server

Vollständiger MCP-Server für die Verwaltung von Google Ads mit komplettem CRUD, Dashboard-Ansicht, Berichten und Verwaltung aller im Google Ads-Panel verfügbaren Funktionen.

Funktionen (85+ Tools)

Konten & Kunden

• list_accessible_customers — Zugängliche Konten auflisten

• get_customer_details — Kontodetails

• list_customer_clients — Kunden unter MCC

• update_customer — Einstellungen aktualisieren

• get_account_hierarchy — Kontohierarchie

• get_change_history — Änderungsverlauf

Kampagnen (Vollständiges CRUD)

• list_campaigns — Kampagnen mit Filtern auflisten

• get_campaign — Vollständige Kampagnendetails

• create_campaign — Kampagne erstellen (Search, Display, Shopping, Video, Performance Max usw.)

• update_campaign — Name, Status, Gebote, Daten aktualisieren

• remove_campaign — Kampagne entfernen

• get_campaign_performance — Leistungskennzahlen

• copy_campaign — Kampagneneinstellungen kopieren

Anzeigengruppen (Vollständiges CRUD)

• list_ad_groups — Anzeigengruppen auflisten

• get_ad_group — Gruppendetails

• create_ad_group — Anzeigengruppe erstellen

• update_ad_group — Einstellungen aktualisieren

• remove_ad_group — Gruppe entfernen

• get_ad_group_performance — Leistungskennzahlen

Anzeigen (Vollständiges CRUD)

• list_ads — Anzeigen auflisten

• get_ad — Anzeigendetails

• create_responsive_search_ad — RSA mit Headlines und Descriptions erstellen

• update_ad_status — Anzeige aktivieren/pausieren

• remove_ad — Anzeige entfernen

• get_ad_performance — Leistungskennzahlen

Keywords (Vollständiges CRUD)

• list_keywords — Keywords mit Quality Score auflisten

• add_keywords — Keywords hinzufügen (Exact, Phrase, Broad)

• update_keyword — Gebot, Status, URLs aktualisieren

• remove_keyword — Keyword entfernen

• get_keyword_performance — Leistung mit Impression Share

• get_search_terms — Suchbegriff-Bericht

• add_negative_keywords — Negative Keywords hinzufügen (Kampagne oder Anzeigengruppe)

Budgets & Gebotsstrategien

• list_budgets — Budgets auflisten

• create_budget — Budget erstellen

• update_budget — Wert/Auslieferungsmethode aktualisieren

• remove_budget — Budget entfernen

• list_bidding_strategies — Strategien auflisten

• create_bidding_strategy — Strategie erstellen (Target CPA, Target ROAS usw.)

• update_bidding_strategy — Strategie aktualisieren

• remove_bidding_strategy — Strategie entfernen

Zielgruppen & Targeting

• list_audiences — Zielgruppen/User-Listen auflisten

• get_audience_performance — Zielgruppen-Performance

• list_campaign_targeting — Targeting-Kriterien

• add_campaign_location_targeting — Geografisches Targeting

• add_campaign_language_targeting — Sprach-Targeting

• add_ad_schedule — Anzeigenplanung (Dayparting)

• remove_campaign_criterion — Kriterium entfernen

• get_geo_target_constants — Geografische Konstanten abrufen

• get_demographics_performance — Demografische Performance

Assets & Erweiterungen

• list_assets — Alle Assets auflisten

• create_sitelink_asset — Sitelink erstellen

• create_callout_asset — Callout erstellen

• create_structured_snippet_asset — Strukturierte Snippets erstellen

• create_call_asset — Anruferweiterung erstellen

• create_price_asset — Preiserweiterung erstellen

• create_promotion_asset — Werbeaktion-Erweiterung erstellen

• create_lead_form_asset — Lead-Formular erstellen

• link_asset_to_campaign — Asset mit Kampagne verknüpfen

• link_asset_to_ad_group — Asset mit Anzeigengruppe verknüpfen

• remove_asset — Asset entfernen

• get_asset_performance — Asset-Performance

• list_campaign_assets — Assets einer Kampagne

• remove_campaign_asset — Asset-Verknüpfung aufheben

Conversions

• list_conversion_actions — Conversion-Aktionen auflisten

• get_conversion_action — Conversion-Details

• create_conversion_action — Conversion-Aktion erstellen

• update_conversion_action — Conversion aktualisieren

• remove_conversion_action — Conversion entfernen

• get_conversion_performance — Conversion-Performance

Berichte & Dashboard

• execute_gaql_query — Benutzerdefinierte GAQL-Abfrage ausführen

• get_account_dashboard — Vollständiges Konto-Dashboard

• get_campaign_dashboard — Detailliertes Kampagnen-Dashboard

• get_performance_by_device — Leistung nach Gerät

• get_performance_by_network — Leistung nach Netzwerk

• get_performance_by_hour — Leistung nach Stunde

• get_performance_by_day_of_week — Leistung nach Wochentag

• get_geographic_performance — Geografische Leistung

• get_landing_page_performance — Landingpage-Leistung

• compare_date_ranges — Zeiträume vergleichen

Labels & Gemeinsame Listen

• list_labels — Labels auflisten

• create_label — Label erstellen

• remove_label — Label entfernen

• apply_label_to_campaign — Label auf Kampagne anwenden

• apply_label_to_ad_group — Label auf Anzeigengruppe anwenden

• list_shared_sets — Gemeinsame Listen auflisten

• create_shared_set — Gemeinsame Negativliste erstellen

• add_shared_set_criteria — Begriffe zur Liste hinzufügen

• link_shared_set_to_campaign — Liste mit Kampagne verknüpfen

Empfehlungen & Optimierung

• list_recommendations — Google-Empfehlungen auflisten

• apply_recommendation — Empfehlung anwenden

• dismiss_recommendation — Empfehlung ignorieren

• get_optimization_score — Optimierungs-Score

Experimente & Änderungen

• list_experiments — Tests auflisten

• list_experiment_arms — Varianten auflisten

• get_change_status — Aktuelle Änderungen

Voraussetzungen

1. Google Cloud-Projekt mit aktivierter Google Ads API

2. OAuth2-Client-ID vom Typ Desktop

3. Developer Token von Google Ads (erhältlich im API Center)

4. Node.js >= 18

Installation

npm install
npm run build

Konfiguration

Option 1: Umgebungsvariablen

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

Option 2: Interaktives Setup

npm run auth

Dadurch wird eine Datei mit den Anmeldedaten unter ~/.google-ads-mcp/credentials.json erstellt.

Konfiguration in Claude Code

Fügen Sie Folgendes zu Ihrer ~/.claude/settings.json hinzu:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Verwendung

Nach der Konfiguration sind alle Tools verfügbar:

• "Liste alle meine aktiven Kampagnen auf"

• "Erstelle eine Search-Kampagne mit einem Budget von 50 € pro Tag"

• "Zeige das Performance-Dashboard der letzten 30 Tage"

• "Füge diese Keywords zur Anzeigengruppe X hinzu"

• "Pausiere Kampagne Y"

• "Zeige den Suchbegriffe-Bericht"

• "Welche Empfehlungen hat Google für mein Konto?"

API-Version

Dieser Server verwendet die Google Ads API v23 (aktuellste Version, veröffentlicht im Januar 2026).

Projektstruktur

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions