Google Ads Manager MCP server

Google Ads Manager MCP

Unofficial, community-maintained project. Not affiliated with, endorsed by, or sponsored by

Google. "Google Ads" is a trademark of Google LLC.

A local MCP (Model Context Protocol) server that lets an AI assistant read and manage a Google Ads account: run GAQL reports, create campaigns, pause/enable campaigns, and add keywords.

Google also publishes an official Google Ads MCP server, which is read-only (reporting/diagnostics only). This project covers the same reporting ground and adds write support — creating and editing campaigns, budgets, ad groups, keywords, and ads — gated behind a draft/confirm safety layer so nothing changes in your account by accident.

Every write goes through a draft → confirm safety flow: the tool that "creates" or "updates" something only validates the change against Google's API (validateonly) and hands back a draftId with a preview. Nothing changes in your Ads account until you call confirmwrite with that draftId. Drafts expire after 10 minutes.

Tools

Read-only:

• listaccessiblecustomers — which accounts this refresh token can reach
• search_gaql — run any raw GAQL SELECT query
• get_campaigns — campaigns with status, budget, and core metrics
• getadgroups — ad groups (optionally filtered to a campaign) with metrics
• get_keywords — keyword criteria with match type, status, and metrics
• getsearchterms — actual search terms that triggered your ads, for finding negative keyword candidates

Write (draft → confirm):

• create_campaign — new campaign + budget, created PAUSED unless you say otherwise
• updatecampaignstatus — enable / pause / remove a campaign
• updatecampaignbudget — change an existing campaign's daily budget
• add_keywords — add keyword criteria to an ad group
• createadgroup — new ad group inside an existing campaign
• updateadgroup_status — enable / pause / remove an ad group
• updatekeywordstatus — enable / pause / remove a keyword criterion
• addnegativekeywords — add negative keyword criteria to an ad group
• createresponsivesearch_ad — new responsive search ad, created PAUSED unless you say otherwise
• confirm_write — execute a previously returned draftId for real

Setup

1. Google Ads developer token

Google Ads → Tools & Settings → API Center. Test-account tokens are issued instantly; a production-level token requires Google's manual review (roughly 1-2 weeks), so apply for that early if you'll use this beyond a test account.

2. OAuth client

Google Cloud Console → APIs & Services → Credentials → Create credentials → OAuth client ID. Choose application type Desktop app. Copy the client ID and client secret.

3. Configure environment

cp .env.example .env

Fill in GOOGLEADSCLIENTID, GOOGLEADSCLIENTSECRET, GOOGLEADSDEVELOPERTOKEN, and GOOGLEADSCUSTOMERID (the account this server should manage — 10 digits, dashes optional). If that account is a client under a manager (MCC) account, also set GOOGLEADSLOGINCUSTOMERID to the manager account's ID.

4. Get a refresh token

npm install
npm run auth

This opens an authorization URL — open it, sign in with the Google account that has access to your Ads account, approve the adwords scope. The script prints a GOOGLEADSREFRESH_TOKEN; add it to .env.

5. Build

npm run build

6. Point your MCP client at it

For Claude Desktop / Claude Code, add to your MCP config:

{
  "mcpServers": {
    "google-ads-manager": {
      "command": "node",
      "args": ["/absolute/path/to/google ads manger mcp/build/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "...",
        "GOOGLE_ADS_CLIENT_SECRET": "...",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "...",
        "GOOGLE_ADS_REFRESH_TOKEN": "...",
        "GOOGLE_ADS_CUSTOMER_ID": "..."
      }
    }
  }
}

Shortened. The full README is on GitHub.