Log inSubmit server
Google Ads logo

Google Ads

Query Google Ads accounts, performance, keywords, assets, forecasts, and campaign changes through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google Ads

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "google-ads-6": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-ads-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_VALUE_HERE",
        "GOOGLE_ADS_CLIENT_ID": "YOUR_VALUE_HERE",
        "GOOGLE_ADS_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_VALUE_HERE",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Google Ads MCP server connects an MCP client directly to the Google Ads API for account data, reporting, keyword research, forecasts, and campaign operations. It provides guided reporting tools, raw GAQL access, query validation, and read-only connectivity checks. Keyword Planner functions cover ideas, historical metrics, and temporary campaign forecasts outside GAQL. Reach for it when an agent needs to inspect or plan Google Ads activity using your own credentials.

Use cases

  • Review campaign and keyword performance
  • Generate keyword ideas from a site or seed terms
  • Forecast traffic and conversion outcomes
  • Inspect Performance Max and Shopping assets
  • Preview proposed campaign changes

Key features

  • Google Ads account and hierarchy discovery
  • GAQL execution and query validation
  • Keyword Planner ideas, history, and forecasts
  • Campaign and performance reporting
  • Performance Max, Shopping, and creative asset reads
  • Preview-first write operations

Tools45

What Google Ads lets your agent do. Expand a tool for its parameters.

Self-reported~1.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3h ago via OSV.dev · @getmcpads/google-ads-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads781Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Tools exposed45Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Google Ads works

What the Google Ads MCP server does

The Google Ads MCP server exposes Google Ads account and reporting operations through MCP. It can list accessible customer accounts, inspect account relationships, retrieve campaigns, ad groups, budgets, bidding strategies, conversion actions, recommendations, and recent change events. Performance tools cover keywords, search terms, landing pages, Shopping products, paid and organic search, Performance Max placements and assets, and Demand Gen creatives.

The server also includes Keyword Planner operations. Agents can generate keyword ideas from seed terms, URLs, keywords combined with URLs, or an entire site; retrieve historical search-volume metrics; and forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign.

Read operations are the main interface. The repository also supports optional write operations for campaign changes, but writes are disabled by default and preview the proposed change before applying it.

How it works

The Google Ads MCP server sends requests directly to the Google Ads platform using credentials supplied by the operator. Structured tools handle common reports, while google_ads_run_gaql accepts raw Google Ads Query Language for custom queries. google_ads_validate_query checks metric, dimension, and resource compatibility before execution, helping avoid invalid API combinations.

Some Google Ads services are not available through GAQL. Dedicated Keyword Planner tools cover the documented planning workflows, while the broader source release also describes a read-only RPC path for services outside GAQL. The health check verifies credentials and reports reachable accounts without exposing secrets.

Asset tools return account image assets, YouTube video assets, and resolved Demand Gen creative references. Depending on the tool, responses can include public image URLs, video identifiers, thumbnails, dimensions, file types, and performance context.

Setup and configuration

Install the documented source release with Node.js 22.12 or newer, then install dependencies and build the project. Configure an MCP client to run the resulting dist/cli.js, or use the npm package through npx as shown in the repository examples.

Required environment variables are GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, and GOOGLE_ADS_REFRESH_TOKEN. A developer token comes from a manager account and may require Google review for live-account access. The OAuth client must belong to a Google Cloud project with the Google Ads API enabled. A refresh token is also required.

Set GOOGLE_ADS_LOGIN_CUSTOMER_ID when querying accounts managed through an MCC. The value may include dashes. Run the health-check tool first to confirm credential validity and account access.

Tools and capabilities

The Google Ads MCP server supports:

  • Account discovery, account details, hierarchy, and connectivity checks.
  • Campaign, ad group, budget, bidding, conversion, recommendation, and change-event reads.
  • GAQL execution, query validation, and structured performance reporting.
  • Keyword ideas, historical metrics, and forecast metrics through Keyword Planner.
  • Shopping, Search, landing-page, Performance Max, Demand Gen, and paid-organic reports.
  • Image, video, and creative asset discovery with resolved media references.
  • Preview-first campaign writes when explicitly enabled.

Limitations and notes

Google reviews developer-token applications, so live-account setup may take time. A manager account requires the correct login customer ID or successful manager discovery. The standalone repository provides native API tools; hosted product interfaces and creative galleries described in the project materials are separate. Review current tool schemas before reusing saved arguments, especially after upgrades.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Google Ads

Google Ads is an MCP server that connects AI clients to the Google Ads API. Its main tools list accounts, inspect campaigns and performance, run or validate GAQL queries, generate Keyword Planner ideas and forecasts, retrieve advertising assets, and preview supported campaign changes before they are applied.

Install it with Node.js 22.12 or newer, then clone the source, run `npm ci`, and build with `npm run build`, or configure an MCP client to use the published npm package with `npx`. The client must provide the required Google Ads credentials.

It needs a Google Ads developer token, OAuth client ID, OAuth client secret, and refresh token. Enable the Google Ads API in a Google Cloud project, obtain the OAuth values, and set a login customer ID when accessing accounts through a manager account.

Yes, Google Ads works with Cursor through its MCP configuration. Add the server and required environment variables to `.cursor/mcp.json`; the repository also documents setup for Claude Desktop and Claude Code.

No, write operations are disabled by default. When enabled, supported changes preview the proposed operation before applying it, while the listed reporting, account, planning, and asset tools provide read access.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGoogle Ads AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/google-ads-6?style=directory)](https://allmcps.com/mcp/google-ads-6)
HTML Embed
<a href="https://allmcps.com/mcp/google-ads-6"><img src="https://allmcps.com/api/badge/google-ads-6?style=directory" alt="Google Ads on AllMCPs" /></a>