Google Ads MCP Server
Give your AI agent
live Google Ads
access.
AdsAgent is a production-ready Model Context Protocol server for Google Ads. Drop it into Claude Desktop, Claude Code, or any MCP-compatible client — and your AI gets live campaign data plus the ability to take reviewed actions.
Free to connect · 2-minute setup · No API key needed
{
"mcpServers": {
"adsagent": {
"command": "npx",
"args": ["-y", "@adsagent/mcp"]
}
}
}Compatible with: Claude Desktop · Claude Code · Claude Cowork · Any MCP stdio client
MCP Tools
Everything your agent can do.
Read tools return live data. Write tools stage a change for your review before anything touches your account.
| Tool | Type | What it does |
|---|---|---|
| listCampaigns | Read | Live campaign performance, spend, and status |
| getKeywords | Read | Keyword bids, Quality Scores, impressions |
| getSearchTermReport | Read | Actual search queries triggering your ads |
| getCampaignPerformance | Read | Deep metrics over any date range |
| runAudit | Read | Full account audit with prioritized recommendations |
| getSpendReport | Read | Spend breakdown by campaign and ad group |
| updateBid | Write | Adjust keyword or ad group bids — reviewable |
| pauseCampaign | Write | Pause underperforming campaigns |
| addNegativeKeyword | Write | Block wasted search terms instantly |
2-minute setup
From zero to live campaign data.
Add to your MCP config
Paste one JSON snippet into Claude Desktop, Claude Code, or Claude Cowork. No API keys needed at this step.
Connect Google Ads via OAuth
One-click at adsagent.org. Read-only until you explicitly approve a change — your account stays safe.
Query your account in plain English
Ask "which campaigns are wasting money?" and get a specific answer backed by live data — no CSV exports.
Read-only by default
Your agent sees everything but changes nothing until you approve each action explicitly.
OAuth 2.0 auth
Google's standard OAuth. Your credentials never touch AdsAgent's servers — tokens stay local.
Production-ready
Not a demo. Proper error handling, pagination, and MCP protocol compliance out of the box.
No code required
Not a developer? Still works.
The setup is editing a JSON file — copy, paste, save. After that it's entirely natural language. Ask Claude questions about your campaigns and let it do the analysis.
- “Which campaigns are wasting the most money?”
- “Show me my top search terms this week”
- “Which keywords have the worst Quality Score?”
- “Run a full audit on my account”
For a step-by-step guide, see the Claude walkthrough →
What you ask
“Which campaigns spent over $500 last month with zero conversions?”
What Claude does
Calls getCampaignPerformance with your date range, filters for cost > $500 and conversions = 0, then returns a ranked list with spend breakdown and top wasted search terms for each.
What you decide
Approve, modify, or skip each recommended action. Nothing changes until you say so.
Frequently asked questions
What MCP clients does AdsAgent support?
Any client that supports the MCP stdio transport: Claude Desktop, Claude Code, Claude Cowork, and third-party MCP clients. If it can run an npx subprocess, it works.
Is the Google Ads MCP server read-only safe?
Yes. Read and write tools are distinct. You can configure your MCP client to expose only read tools. All write operations also show a preview before executing — nothing changes without your explicit confirmation.
What OAuth scopes does AdsAgent request?
Only the Google Ads API scope. No Gmail, Calendar, or other Google services are requested.
Does AdsAgent support manager accounts (MCCs)?
Yes. If your OAuth account has access to multiple Google Ads accounts, you can specify the customer ID at runtime. Manager account hierarchies are supported.
How do I install the Google Ads MCP server?
Add the following to your MCP config: {"mcpServers":{"adsagent":{"command":"npx","args":["-y","@adsagent/mcp"]}}}. No global install required — npx pulls the latest version on demand.
How is AdsAgent different from using the Google Ads API directly?
The Google Ads API requires a developer token, OAuth setup, and writing GAQL queries by hand. AdsAgent wraps all of that into typed MCP tools your AI agent can call through natural language — no API knowledge required.
What happens if a tool call fails?
AdsAgent returns structured error messages through the MCP protocol. Your agent sees the error, can reason about it, and can retry or escalate. No silent failures.
Connect the Google Ads MCP server.
Free. 2-minute setup. Your agent gets live access to every campaign, keyword, and search term in your account.
Read-only OAuth · changes require approval · no credit card