Google Ads MCP

Name: Google Ads MCP
Author: scalably-io

von scalably-ioVersion 1.0.1i★ –iLäuft auf deinem Computer

Name in der Registryio.scalably/google-ads-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Marketing & Social Media
Das musst du eintragen: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID, GOOGLE_ADS_API_VERSION, GOOGLE_ADS_LOG_LEVEL, GOOGLE_ADS_USE_PROTO_PLUS

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Die .mcpb-Datei des Entwicklers herunterladen

Der Link führt zur Datei des Entwicklers selbst; wir hosten sie nicht und verpacken sie nicht neu. Öffne die Datei, dann installiert Claude Desktop sie.

Führe das in deinem Terminal aus

claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=your-value --env GOOGLE_ADS_CLIENT_ID=your-value --env GOOGLE_ADS_CLIENT_SECRET=your-value --env GOOGLE_ADS_REFRESH_TOKEN=your-value --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=your-value --env GOOGLE_ADS_API_VERSION=your-value --env GOOGLE_ADS_LOG_LEVEL=your-value --env GOOGLE_ADS_USE_PROTO_PLUS=your-value -- uvx scalably-google-ads-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "scalably-google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
        "GOOGLE_ADS_CLIENT_ID": "your-value",
        "GOOGLE_ADS_CLIENT_SECRET": "your-value",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-value",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your-value",
        "GOOGLE_ADS_API_VERSION": "your-value",
        "GOOGLE_ADS_LOG_LEVEL": "your-value",
        "GOOGLE_ADS_USE_PROTO_PLUS": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "google-ads": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "scalably-google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
        "GOOGLE_ADS_CLIENT_ID": "your-value",
        "GOOGLE_ADS_CLIENT_SECRET": "your-value",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-value",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your-value",
        "GOOGLE_ADS_API_VERSION": "your-value",
        "GOOGLE_ADS_LOG_LEVEL": "your-value",
        "GOOGLE_ADS_USE_PROTO_PLUS": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

GOOGLE_ADS_DEVELOPER_TOKEN geheim erforderlich env
Google Ads API developer token from the Ads API Center
GOOGLE_ADS_CLIENT_ID erforderlich env
OAuth2 client_id for a Desktop-app credential
GOOGLE_ADS_CLIENT_SECRET geheim erforderlich env
OAuth2 client_secret paired with the client_id
GOOGLE_ADS_REFRESH_TOKEN geheim erforderlich env
Long-lived OAuth2 refresh_token for the adwords scope
GOOGLE_ADS_LOGIN_CUSTOMER_ID erforderlich env
10-digit customer ID of the manager account (MCC)
GOOGLE_ADS_API_VERSION env
Google Ads API version to target, default set by the server
GOOGLE_ADS_LOG_LEVEL env
Log level, default WARNING
GOOGLE_ADS_USE_PROTO_PLUS env
Use proto-plus message types, default true

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde über die Domain scalably.io bestätigt (die Registry prüft, wem die Domain gehört)
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Marketing & Social Mediai

Mehr Sterne als 0 % der anderen 2984 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 32 % der anderen 2984 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 2984 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Google Ads MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (1.0.1) kam vor 2 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv), MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

MCP YouTube Transcript

von jkawamoto

An MCP server retrieving transcripts of YouTube videos

Läuft auf deinem Computer★ 495MITAktualisiert vor 10 Tagen

Installieren

Google Analytics MCP

von surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Läuft auf deinem Computer★ 244MITAktualisiert vor 10 Tagen

Installieren

BibiGPT YouTube Video Summarizer

von JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

Läuft in der Cloud★ 137MITAktualisiert vor 10 Tagen

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Google Ads MCP

Read-only MCP server for the Google Ads API. Eleven tools cover discovery, GAQL reporting, resource schema, recommendations, keyword planning and forecasts, and change history for any account reachable under a manager account (MCC). We run this server in production for every ads client. Read-only is enforced at three layers: no mutate or apply service imports, an SDK method allowlist, and a GAQL-starts-with-SELECT guard.

Install

Claude Code:

claude mcp add google-ads \

-e GOOGLE_ADS_DEVELOPER_TOKEN=your-token \ -e GOOGLE_ADS_CLIENT_ID=your-client-id \ -e GOOGLE_ADS_CLIENT_SECRET=your-client-secret \ -e GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token \ -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \ -- uvx scalably-google-ads-mcp

Codex:

codex mcp add google-ads \

--env GOOGLE_ADS_DEVELOPER_TOKEN=your-token \ --env GOOGLE_ADS_CLIENT_ID=your-client-id \ --env GOOGLE_ADS_CLIENT_SECRET=your-client-secret \ --env GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token \ --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \ -- uvx scalably-google-ads-mcp

Claude Desktop: download google-ads-mcp.mcpb from the latest GitHub release and open it.

Setup

This is the heaviest setup in the gallery: expect up to two days waiting on developer token approval. One set of credentials, rooted at a manager account (MCC), can read any customer account linked under it, so there is no per-client configuration beyond linking an account to the MCC.

Google Ads developer token. Sign in at ads.google.com under your manager account, go to Tools and Settings, API Center, and apply for a developer token. A new token starts on the Explorer access level, which Google grants after a review that can take a few days; discovery, query and recommendation tools work there. Basic access (a separate application) is needed for higher quotas and may be needed for the keyword-planning tools.
Google Cloud OAuth client. In a Google Cloud project, enable the Google Ads API, then create an OAuth client ID of type Desktop app under APIs and Services, Credentials. Note the client ID and client secret, and add the https://www.googleapis.com/auth/adwords scope to the OAuth consent screen.
Refresh token. Generate a refresh token once, as an admin user of the manager account, using Google's oauth2l tool or the generate_user_credentials.py example shipped with the google-ads Python library. Save the refresh token; it does not expire from normal use.
Login customer ID. Use the 10-digit customer ID of the manager account itself (no hyphens) as GOOGLE_ADS_LOGIN_CUSTOMER_ID. Any client account accepts an invite to link under this manager account in its own Google Ads UI, after which google_ads_list_customer_clients sees it.

Tools (11)

Tool	What it does
`google_ads_list_accessible_customers`	List every customer_id the OAuth user has direct access to
`google_ads_list_customer_clients`	Walk the MCC hierarchy and return every child account
`google_ads_query`	Run a GAQL query against a specific customer account
`google_ads_describe_resource`	Schema (fields, metrics, segments) for a GAQL resource
`google_ads_list_resources`	Return the full catalog of GAQL resources
`google_ads_recommendations`	Read Google's optimization recommendations for a customer account
`google_ads_keyword_ideas`	Generate keyword ideas with search volume, competition and CPC estimates
`google_ads_keyword_historical_metrics`	Historical monthly search-volume and competition metrics for specific keywords
`google_ads_keyword_forecast_metrics`	Forecast KPIs for a proposed keyword plan
`google_ads_change_events`	Audit trail of who changed what, last 30 days
`google_ads_change_status`	Lightweight last-modified change tracker per resource

Configuration

Variable	Required	Purpose
`GOOGLE_ADS_DEVELOPER_TOKEN`	yes	Google Ads API developer token from the Ads API Center
`GOOGLE_ADS_CLIENT_ID`	yes	OAuth2 client_id for a Desktop-app credential
`GOOGLE_ADS_CLIENT_SECRET`	yes	OAuth2 client_secret paired with the client_id
`GOOGLE_ADS_REFRESH_TOKEN`	yes	Long-lived OAuth2 refresh_token for the adwords scope
`GOOGLE_ADS_LOGIN_CUSTOMER_ID`	yes	10-digit customer ID of the manager account (MCC), no hyphens
`GOOGLE_ADS_API_VERSION`	no	Google Ads API version to target, default v25
`GOOGLE_ADS_USE_PROTO_PLUS`	no	Use proto-plus message types, default true
`GOOGLE_ADS_LOG_LEVEL`	no	Python log level, default WARNING

Reply shape

Every tool returns JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures surface as a tool error whose text is google_ads_request_failed: . proof.apiVersion names the Google Ads API version used. proof.microsConverted is set on google_ads_query. A partial status means the result hit its configured bound (max_rows, page_size or limit); recovery.nextAction says how to continue.

Limits

google_ads_query responses are capped at 64 MB per call by the Google Ads API; split large date ranges across calls. KeywordPlanIdeaService (keyword ideas, historical metrics, forecasts) is rate-limited to 1 query per second and may require Basic Access if you get a permission error on the Explorer tier. google_ads_change_events covers up to 30 days back; google_ads_change_status covers up to 14 days back. metrics.cost_micros and other *_micros fields are 1 unit = $0.000001; google_ads_query emits a matching *_units field alongside when convert_micros is true (the default).

Verify

Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the built wheel on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html

Google Ads MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Marketing & Social Mediai

Häufige Fragen

Alternativen

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

README vom Entwickler

Google Ads MCP

Install

Setup

Tools (11)

Configuration

Reply shape

Limits

Verify

Privacy Policy

License