# Google Ads API MCP Setup

Guides developers through downloading, configuring, and installing the official...

- Repository: https://github.com/google/skills (21764 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/skills --skill google-ads-api-mcp-setup -g -a claude-code -y`
Codex: `npx skills add google/skills --skill google-ads-api-mcp-setup -g -a codex -y`
Cursor: `npx skills add google/skills --skill google-ads-api-mcp-setup -g -a cursor -y`
Gemini CLI: `npx skills add google/skills --skill google-ads-api-mcp-setup -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add google/skills`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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](https://github.com/googleads/google-ads-mcp)**.

---

## 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:

The rest: https://github.com/google/skills/blob/HEAD/skills/ads/google-ads-api-mcp-setup/SKILL.md
