Log inSubmit server
MCP Gads logo

MCP Gads

Query Google Ads accounts, campaigns, keywords, assets, and performance data through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Gads

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": {
    "mcp-gads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-gads"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_VALUE_HERE",
        "GOOGLE_ADS_CREDENTIALS_PATH": "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.

Automated check passed— started and listed 36 tools correctly (9d ago).

Overview

The mcp-gads MCP server connects MCP clients to the Google Ads API for account discovery, GAQL queries, reporting, keyword research, and asset analysis. It uses OAuth credentials and a Google Ads developer token, with optional support for manager accounts and selected mutations. Reach for it when an agent needs to inspect advertising data, compare performance, investigate search terms, or make controlled account changes.

Use cases

  • Inspect campaign performance and spending
  • Query Google Ads data with GAQL
  • Research keyword ideas and search volumes
  • Analyze asset usage and performance
  • Review account changes and recommendations

Key features

  • Google Ads account and MCC hierarchy access
  • Custom GAQL queries with table, JSON, and CSV output
  • Campaign, ad, keyword, asset, and conversion reporting
  • Keyword Planner and search-term analysis
  • Optional campaign, ad, budget, and negative-keyword mutations

Tools36

What MCP Gads lets your agent do. Expand a tool for its parameters.

Verified live~4.7k 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 2d ago

Recent health check succeeded.

7/7 checks healthy over the last 45d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · mcp-gads (npm)

Adoption & maintenance

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

GitHub stars1Stargazers on the source repository.
npm downloads411Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed36Callable tools this server registers over MCP.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Gads works

What mcp-gads MCP server does

The mcp-gads MCP server exposes Google Ads data and operations as tools that an MCP-compatible AI client can call. It covers account access, manager-account hierarchies, currency lookup, campaign and ad reporting, budgets, keywords, search terms, locations, devices, recommendations, and account change history.

Its query layer supports Google Ads Query Language (GAQL). Agents can run custom queries, request help with GAQL syntax, and list valid resources for a query's FROM clause. Results can be returned as tables, JSON, or CSV through the formatted query tool.

Reporting tools provide campaign, ad group, ad, conversion, impression-share, and scheduling data. Asset tools inspect image assets, their dimensions, usage, performance, and downloadable files. Keyword tools generate ideas from seed terms, retrieve historical volumes, expose quality-score components, and examine queries that triggered ads. Paid-versus-organic query data requires a linked Search Console account.

How it works

The server runs over MCP using stdio. An AI client invokes individual tools with account and reporting parameters rather than interacting with the Google Ads web interface. A default customer ID can be configured to avoid passing the same account identifier to every tool, while a login customer ID supports access through an MCC manager account.

Most capabilities are read-oriented. Optional mutation tools can pause or enable campaigns, ad groups, and ads; change a campaign's daily budget; and add negative keywords. These operations are disabled unless the relevant configuration flag is enabled.

Setup and configuration

Running the mcp-gads MCP server requires a Google Ads developer token and an OAuth client credentials JSON file. Set these values with GOOGLE_ADS_DEVELOPER_TOKEN and GOOGLE_ADS_CREDENTIALS_PATH, then run the setup command to complete browser-based authorization and save a refresh token.

The package can be launched with npx, bunx, a global installation, or a prebuilt platform binary. Node 22 or newer is required when using npx. Claude Code, Claude Desktop, and Codex can configure the server as a stdio process; Codex requires environment variables inside its MCP server configuration and absolute credential-file paths. A startup timeout increase may be needed when Codex downloads the package through npx.

Optional settings include the authentication mode, a default Google Ads customer ID, an MCC login customer ID, and GOOGLE_ADS_ENABLE_MUTATIONS=true for write operations.

Tools and capabilities

The mcp-gads MCP server includes tools for:

  • Listing accessible accounts, currencies, and MCC account trees.
  • Running custom GAQL queries and consulting GAQL resources and examples.
  • Reviewing campaign, ad group, ad, budget, conversion, geographic, device, schedule, and impression-share performance.
  • Inspecting RSA copy, image assets, asset usage, asset performance, and downloaded image files.
  • Generating keyword ideas, checking search volumes, reviewing quality scores, and analyzing search demand.
  • Reading recommendations, change history, landing-page data, placements, video results, labels, and audience breakdowns.
  • Enabling optional status, budget, and negative-keyword changes.

Limitations and notes

Google Ads API access still depends on the credentials, developer token, account permissions, and customer relationships available to the configured user. Paid-organic reporting needs a Search Console link. Mutation tools are off by default, so read-only behavior is the default configuration. Relative credential paths can fail in clients that launch the process from a different working directory; use an absolute path when the client documents its own working directory.

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 MCP Gads

mcp-gads is an MCP server that connects AI clients to the Google Ads API and exposes account discovery, GAQL querying, campaign and ad reporting, asset inspection, keyword research, and related analysis tools. It can also expose selected campaign, ad group, ad, budget, and negative-keyword mutations when explicitly enabled.

Install it with npx, bunx, a global npm package, or a prebuilt binary. Set the Google Ads developer token and OAuth credentials path, run the setup command for authorization, then register the process with your MCP client.

It requires a Google Ads developer token and an OAuth client credentials JSON file. Configure them with GOOGLE_ADS_DEVELOPER_TOKEN and GOOGLE_ADS_CREDENTIALS_PATH, then complete the browser-based setup flow to create a refresh token.

Yes, but mutations are disabled by default. Set GOOGLE_ADS_ENABLE_MUTATIONS=true to expose tools that can change campaign, ad group, and ad status, update a campaign budget, or add negative keywords.

Yes. The README explicitly states that mcp-gads works with Cursor, and it runs as a standard stdio MCP server with the required Google Ads environment variables.

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 PreviewMCP Gads AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-gads?style=directory)](https://allmcps.com/mcp/mcp-gads)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-gads"><img src="https://allmcps.com/api/badge/mcp-gads?style=directory" alt="MCP Gads on AllMCPs" /></a>