Google Ads MCP Pro

Stop reading dashboards. Start changing them.

A Model Context Protocol server that gives your AI assistant full read and write control over Google Ads — build campaigns, fix targeting leaks, rewrite ads, and switch bidding strategies without ever opening the browser.

Why this exists

Most Google Ads MCP servers are read-only. They tell you your CPC went up. They can't lower it.

This one closes the loop:

"Impression share is 12%. Why?"
  → queries the API, finds 80% lost to budget

"Fix it."
  → creates a dedicated budget, relinks the campaign,
    switches to Maximize Conversions, verifies the change

That whole exchange happens in chat. No browser. No clicking through six settings screens.

Real story: this fork was built while managing a live account. It found a campaign silently locked out of smart bidding by a shared-budget flag, a geo-targeting setting leaking spend to three foreign countries, and a sitelink contradicting the site's own lead flow — then fixed all three through the API. Read-only tooling would have surfaced none of it.

Related MCP server: gads-transparency-mcp

What you can actually do

Every write tool supports validate_only — a real dry run against Google's API that validates without applying. Ask for a preview before anything touches a live account.

Quick start

1. Requirements

• Python 3.11+

• A Google Ads developer token (apply here)

• OAuth desktop credentials from Google Cloud Console

2. Install

git clone https://github.com/saifshabsug/google-ads-mcp-pro.git
cd google-ads-mcp-pro
pip install -r requirements.txt

3. Configure

cp .env.example .env

GOOGLE_ADS_DEVELOPER_TOKEN=your_developer_token
GOOGLE_ADS_CLIENT_ID=your_oauth_client_id
GOOGLE_ADS_CLIENT_SECRET=your_oauth_client_secret
GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890   # your MCC, digits only
GOOGLE_ADS_CREDENTIALS_PATH=./credentials.json
GOOGLE_ADS_AUTH_TYPE=oauth

4. Register with your MCP client

claude mcp add google-ads -- python /full/path/to/google_ads_server.py

{
  "mcpServers": {
    "google-ads": {
      "command": "python",
      "args": ["/full/path/to/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "...",
        "GOOGLE_ADS_CLIENT_ID": "...",
        "GOOGLE_ADS_CLIENT_SECRET": "...",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "...",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/full/path/to/credentials.json",
        "GOOGLE_ADS_AUTH_TYPE": "oauth"
      }
    }
  }
}

First run opens a browser for OAuth consent and caches the token.

🧰 The 43 tools

list_accounts · get_account_currency · get_campaign_performance · get_ad_performance · get_ad_creatives · run_gaql · execute_gaql_query · list_resources · get_image_assets · download_image_asset · analyze_image_assets · get_asset_usage

create_campaign_budget · create_search_campaign · create_ad_group · create_responsive_search_ad · add_keywords · add_location_targeting

update_campaign_status · update_campaign_name · update_campaign_budget_amount · update_campaign_budget_link · update_campaign_bidding · update_campaign_geo_target_type · update_ad_group_bid · update_ad_status · update_responsive_search_ad · update_keyword_status · set_device_bid_modifier

add_negative_keywords · add_ad_group_negative_keywords

add_call_asset · add_sitelinks · add_callouts · add_structured_snippet · add_ad_group_sitelinks · add_ad_group_callouts · remove_campaign_asset

create_conversion_action · update_conversion_action · upload_click_conversion

generate_keyword_ideas · set_ad_schedule

Hard-won gotchas

Things the API docs bury, discovered by hitting them in production:

⚠️ Safety

This server writes to live advertising accounts that spend real money.

• Start with validate_only=true on anything you haven't run before

• Test against a low-budget or paused campaign first

• credentials.json and .env are gitignored — keep it that way

• Developer tokens under Test Access only reach test accounts; Basic Access is needed for production

Provided as-is under MIT. You are responsible for what runs against your account.

Credits

Built on the excellent cohnen/mcp-google-ads by Ernesto Cohnen (ixigo), which provided the read/reporting foundation and OAuth handling. This fork keeps all of it and adds 31 write tools, the Google Ads API v24 upgrade, validate_only dry-run support across every mutation, and the production fixes above.

MIT licensed, original copyright preserved — see LICENSE.

Contributing

Issues and PRs welcome. Especially valuable:

• New write tools (audiences, experiments, Performance Max)

• Additional gotchas for the table above

• Tests against sandbox accounts

Maintained by Saif Shabsug — software consultancy, Amman

If this saved you a browser session, a ⭐ helps others find it.