google-ads-api-mcp-setup

Installs and configures the official Google Ads MCP server for AI assistant integration.

Updated May 11, 2026
One-click install
npx skills add https://github.com/alon3153/upe-social-publisher --skill google-ads-api-mcp-setup-alon3153
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-ads-api-mcp-setup
Source: https://github.com/alon3153/upe-social-publisher/tree/main/.agents/skills/google-ads-api-mcp-setup
Command: npx skills add https://github.com/alon3153/upe-social-publisher --skill google-ads-api-mcp-setup-alon3153

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Connecting an AI assistant like Claude, Cursor, or Gemini to a Google Ads account requires installing the official Google Ads MCP server, configuring OAuth credentials, and wiring up client-specific JSON settings — a process with many failure points. This Skill walks through every step with verification checks and troubleshooting guidance. ## Core Features & Use Cases - Guided Installation: Verifies Python 3.12+ and pipx prerequisites, then installs the official google-ads-mcp package from PyPI with PATH troubleshooting. - Client Integration: Provides ready-to-use configuration for Claude Desktop, Cursor, and Antigravity CLI, including OS-specific config file paths and environment variable setup. - Cloud Deployment: Covers optional deployment to Google Cloud Run with Docker image builds and HTTP-based MCP client configuration. - Use Case: A marketing analyst wants to ask their AI assistant questions like "What is the status of campaigns in account 1234567890?" — this Skill gets the MCP server running so the assistant can query Google Ads via GAQL. ## Quick Start Set up the Google Ads MCP server and connect it to my AI assistant so I can query my campaign data with natural language.

Frequently Asked Questions about google-ads-api-mcp-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the Google Ads MCP server?▼

Install the official google-ads-mcp package using pipx with the command pipx install google-ads-mcp. Python 3.12 or higher and pipx are strictly required prerequisites, and you can verify the installation by running google-ads-mcp --help.

How to connect Claude Desktop to Google Ads?▼

Add a google-ads entry to the mcpServers block in claude_desktop_config.json using pipx as the command and run, google-ads-mcp as arguments. Declare the environment variables GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, and GOOGLE_ADS_REFRESH_TOKEN in the config.

What credentials does the Google Ads MCP server need?▼

The server requires five credentials: a Developer Token, OAuth2 Client ID and Client Secret, an OAuth2 Refresh Token, and a Client Customer ID. A Login Customer ID is also required when working through a Manager Account hierarchy, and all customer IDs must be digits only without hyphens.

Can the Google Ads MCP server modify campaigns?▼

No, the Google Ads MCP server is strictly read-only. It exposes three tools — list_accessible_customers, get_resource_metadata, and search — for querying account data via GAQL, but it cannot modify bids, pause campaigns, or create advertising assets.

Why does the MCP server fail with spawn pipx ENOENT?▼

This error means pipx is not in the PATH of the IDE's environment, since external IDEs often do not inherit shell RC files. Fix it by providing the absolute path to pipx in the command field, such as /usr/local/bin/pipx or ~/.local/bin/pipx.

Can I deploy the Google Ads MCP server to Cloud Run?▼

Yes, you can build a Docker image with Cloud Build, push it to Artifact Registry, and deploy to Cloud Run with FASTMCP_HOST set to 0.0.0.0. MCP clients then connect via the Cloud Run URL using an httpUrl configuration instead of stdio.