Google Ads MCP Server

MCP server acting as an interface to the Google Ads, enabling programmatic access to Google Ads data and management features.

Local serverstdioPython

What is the Google Ads MCP server?

Most cloud and infrastructure work still happens through a UI a human drives. Google Ads MCP server moves it into the conversation instead. MCP server acting as an interface to the Google Ads, enabling programmatic access to Google Ads data and management features.

The short version

Connect Google Ads API directly to Claude Desktop and other MCP clients with seamless OAuth 2.0 authentication, automatic token refresh, GAQL querying, and keyword research capabilities.

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

The tools it exposes

The server publishes 5 tools. What each one is for:

  • list_accounts — List all accessible Google Ads accounts
  • run_gaql — Execute GAQL queries with custom formatting
  • run_keyword_planner — Generate keyword ideas with metrics
  • Issue — Symptoms
  • Prerequisites — Before setting up the MCP server, you'll need: - Python 3.10+ installed - A Google Cloud Platform account - A Google Ads account with API access

What it needs from you

Configuration is passed through the environment: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_OAUTH_CONFIG_PATH, GOOGLE_ADS_LOGIN_CUSTOMER_ID. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Before setting up the MCP server, you'll need: - Python 3.10+ installed - A Google Cloud Platform account - A Google Ads account with API access

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of cloud and infrastructure servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Google Ads's toolset — list_accounts, run_gaql, run_keyword_planner and 2 more — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
list_accountsList all accessible Google Ads accounts
run_gaqlExecute GAQL queries with custom formatting
run_keyword_plannerGenerate keyword ideas with metrics
IssueSymptoms
PrerequisitesBefore setting up the MCP server, you'll need: - Python 3.10+ installed - A Google Cloud Platform account - A Google Ads account with API access

How to install the Google Ads MCP server

{
  "mcpServers": {
    "google-ads": {
      "command": "/full/path/to/your/project/.venv/bin/python",
      "args": [
        "/full/path/to/your/project/server.py"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Before setting up the MCP server, you'll need: - Python 3.10+ installed - A Google Cloud Platform account - A Google Ads account with API access

VariableDescriptionRequired
GOOGLE_ADS_DEVELOPER_TOKENCredential the server authenticates with.Yes
GOOGLE_ADS_OAUTH_CONFIG_PATHFilesystem location the server is allowed to use.Optional
GOOGLE_ADS_LOGIN_CUSTOMER_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Google Ads to list accounts.
  • Use Google Ads to run gaql.
  • Use Google Ads to run keyword planner.

Frequently asked questions

It connects Google Ads to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (list_accounts, run_gaql, run_keyword_planner, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Google Ads directly.