Google Ads MCP

A localMCPserver for reading and writing the Google Ads API. Full campaign management with a dry-run/confirm safety flow on every write.
- Google Ads Manager (MCC) accountwith adeveloper token. Check its access level: Google Ads UI -> Tools & Settings -> Setup -> API Center.

python -m venv .venv . .venv/Scripts/activate # Windows PowerShell: .venv\Scripts\Activate.ps1 pip install -e ".[dev]" # Mint a refresh token (one-off browser consent): python scripts/generate_refresh_token.py --client-id XXX --client-secret YYY cp .env.example .env # then fill in every value

Once.envholds the client ID and secret,python scripts/remint_refresh_token.pyre-mints an expired or revoked refresh token and rewrites.envin place, without printing the secret.

Never commit.env; it is gitignored, and it is the only place real credentials should ever live.

.envkeys:GOOGLE_ADS_DEVELOPER_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_REFRESH_TOKEN,GOOGLE_ADS_LOGIN_CUSTOMER_ID(your MCC ID, dashes optional, shown top-right in the Google Ads UI when logged into the manager account).

pip install -e ".[dev]" pytest -v

Use the venv's absolute python path so registration works regardless of which directory Claude Code is launched from (the server also resolves.envfrom the project root, not the cwd):

# Windows claude mcp add google-ads -- "<REPO_PATH>\.venv\Scripts\python.exe" -m google_ads_mcp.server # macOS / Linux claude mcp add google-ads -- "<REPO_PATH>/.venv/bin/python" -m google_ads_mcp.server

Add--scope userto make the tools available in every project rather than just this one.

Every write tool defaults to apreview: it validates the change with the API'svalidate_onlyand returns aconfirmation_token. To apply, call the same tool again withcommit=trueand that token. The committed operation is byte-for-byte what was previewed. Nothing spends money until you confirm.

Read:list_accounts,run_gaql,get_campaigns,get_ad_groups,get_keywords,get_performance.

Write (preview -> confirm):create_campaign_budget,create_campaign,update_budget,update_campaign_status,create_ad_group,update_ad_group_status,create_responsive_search_ad,add_keywords,add_negative_keywords,apply_mutate.

Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.

AI agents that manage paid ads across Meta, LinkedIn, and Google Ads: campaigns, ad creative, and day-to-day ad operations from any MCP client.

Connect Google Ads to the AI you already use.

MCP server for Google Ads campaign and budget management

Run Google, Meta, LinkedIn, and TikTok ads from any AI (Claude, Chatgpt, Gemini and more)

Manage Meta, Google & TikTok ads — launch campaigns, track performance, spy on competitors, generate AI creatives.

Google ads, Meta ads, TikTok ads, Microsoft ads, Pinterest ads, Amazon ads, Linkedin ads and Reddit ads all from the chat you already use. Safe, robust, made for Agencies.

Launch & manage your User Referral and Partner / Affiliate program — for developers and growth teams.

Let AI clients add payments to your website. Create checkout pages, events and forms and embed them on your site in minutes.

Answers questions on AEO, SEO, web development and branding from the published material of GOJI, a Melbourne digital agency, with a goji.agency URL to cite on every result.