mcp-google-ads · MCP Server

Beschreibung des Anbieters

Google Ads API integration for Model Context Protocol (MCP)

Werkzeuge

list_accounts

Lists all accessible Google Ads accounts. This is typically the first command you should run to identify which accounts you have access to.… Angabe des Anbieters · Beleg 5

execute_gaql_query

Execute a custom GAQL (Google Ads Query Language) query. This tool allows you to run any valid GAQL query against the Google Ads API.… Angabe des Anbieters · Beleg 5

get_campaign_performance

Get campaign performance metrics for the specified time period. RECOMMENDED WORKFLOW: 1. First run list_accounts() to get available account IDs 2.… Angabe des Anbieters · Beleg 5

get_ad_performance

Get ad performance metrics for the specified time period. RECOMMENDED WORKFLOW: 1. First run list_accounts() to get available account IDs 2.… Angabe des Anbieters · Beleg 5

run_gaql

Execute any arbitrary GAQL (Google Ads Query Language) query with custom formatting options. This is the most powerful tool for custom Google Ads data queries.… Angabe des Anbieters · Beleg 5

get_ad_creatives

Get ad creative details including headlines, descriptions, and URLs. This tool retrieves the actual ad content (headlines, descriptions) for review and analysis.… Angabe des Anbieters · Beleg 5

get_account_currency

Retrieve the default currency code used by the Google Ads account. IMPORTANT: Run this first before analyzing cost data to understand which currency the account uses.… Angabe des Anbieters · Beleg 5

get_image_assets

Retrieve all image assets in the account including their full-size URLs.… Angabe des Anbieters · Beleg 5

download_image_asset

Download a specific image asset from a Google Ads account. This tool allows you to download the full-size version of an image asset for further processing, analysis, or backup.… Angabe des Anbieters · Beleg 5

get_asset_usage

Find where specific assets are being used in campaigns, ad groups, and ads.… Angabe des Anbieters · Beleg 5

analyze_image_assets

Analyze image assets with their performance metrics across campaigns.… Angabe des Anbieters · Beleg 5

list_resources

List valid resources that can be used in GAQL FROM clauses. Args: customer_id: The Google Ads customer ID as a string Returns: Formatted list of valid resources Angabe des Anbieters · Beleg 5

Voraussetzungen

• GOOGLE_ADS_CREDENTIALS_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• GOOGLE_ADS_DEVELOPER_TOKEN · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• GOOGLE_ADS_LOGIN_CUSTOMER_ID · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• GOOGLE_ADS_AUTH_TYPE · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• GOOGLE_ADS_IMPERSONATION_EMAIL · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• GOOGLE_ADS_CLIENT_ID · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5
• GOOGLE_ADS_CLIENT_SECRET · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 5

Installation

uv pip install -r requirements.txt

Eckdaten

—: Angabe nicht belegt.

Maintainer

cohnen

Repository-Lizenz

MIT

Letzter Repository-Commit

2025-10-16

Commit innerhalb zwölf Monaten

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

Google Ads

Bereiche

Marketing, Analyse

Plattformen

—

Version

0.1.0

Clients

Claude Desktop, Cursor

Repository-Themen

ai, claude, google-ads, mcp, mcp-server

Homepage

Homepage des Anbieters

Zugriffe und Risiken

Zugriffe laut Paketangaben

lesen

Authentifizierung

—

Transport

—

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe: Vergib nur die nötigen Berechtigungen und sichere Schreibaktionen mit einer Freigabe ab.