Agent skill · marketing growth · google
google-ads-api-mcp-setup
Guides developers through downloading, configuring, and installing the official open-source Google Ads MCP Server. Use this skill when a user wants to connect their AI assistant (such as Gemini, Claude Code, or Cursor) to their Google Ads account to query campaigns or retrieve reporting metrics using natural language.
Why this skill is useful
Provides specific commands and configuration steps for integrating with the Google Ads API that the AI wouldn't reliably generate on its own.
What it needs
Requires pipx, python installed locally. Requires google-ads account access. About 10k tokens when loaded. Last updated 2026-08-06. 15,831 stars on the source repository.
What this skill does
Google Ads API MCP Server Installation This skill provides a structured setup guide to install, configure, and integrate the official open-source Google Ads Model Context Protocol (MCP) Server. --- System Requirements & Compatibility (Agent Action: State Required Prerequisites) When answering questions about installing or setting up the MCP server, you MUST explicitly state to the user that both Python 3.12+ and pipx are strictly required prerequisites for the installation. [!IMPORTANT] Pre-Flight Environment Check: Python Runtime: Version 3.12+ is strictly required. Package Manager: pipx must be installed and globally accessible in the system path. Network Connectivity: Outbound HTTPS access is required to connect to the Google Ads API endpoints (googleads.googleapis.com) and PyPI. --- ⚠️ Prerequisites: Credentials Required [!WARNING] Dependency Check: The MCP server requires the same 5 authentication credentials as a standard integration. If you do not have your Developer Token, Client ID, Client Secret, Refresh Token, and Customer IDs yet: 1. STOP executing this skill. 2. Transition to the google-ads-api-quickstart skill first to generate them, then return here. --- Step 1: Validate Your Google Ads API Credentials The Google Ads MCP Server requires the same five parameters as the standard client libraries. Before proceeding to installation, verify that you have these values secured and formatted correctly: 1. Developer Token: Your unique API access key from the API Center (Manager Account). 2. OAuth2 Client ID & Client Secret: Desktop Application credentials from the Google Cloud Console. 3. OAuth2 Refresh Token: The long-lived token generated via the OAuth consent flow. 4. Client Customer ID: The 10-digit target Google Ads account ID. [!IMPORTANT] Format: Must contain digits only, no hyphens (e.g., 1234567890, NOT 123-456-7890). 5. Login Customer ID (Required for MCC Hierarchies): The 10-digit Manager Account (MCC) ID. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills google/google-ads-api-mcp-setup