Google Ads MCP server
13 operations0 webhooks
Run Google Ads Query Language reports and manage campaigns, budgets and ad groups through the Google Ads API.
Try Google Ads with your agent
Connect Google Ads, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Google Ads on my account, then run one read-only example and show me the result.
Google Ads tools and triggers
Tools are what your agent can do in Google Ads through Corsair's MCP server. Triggers are the Google Ads events a routine can start from.
Campaigns
- CreateDestructive
Create a campaign that starts serving and spending unless status is PAUSED, against an existing budget
campaigns.create
- RemoveDestructive
Remove a campaign: its status becomes REMOVED and it cannot be restored, only recreated as a new campaign
campaigns.remove
- UpdateDestructive
Change a campaign's name, status or dates; enabling it starts spending. updateMask names the fields that change
campaigns.update
Reporting
- MutateDestructive
Mutate any entity in one call: each entry names its own operation, and removing is permanent for that entity
reporting.mutate
- SearchRead-only
Run a Google Ads Query Language statement and read its rows, 10,000 at a time
reporting.search
- Search StreamRead-only
Run a query and read the whole result set in one response, without paging
reporting.searchStream
Ad Groups
- CreateWrite
Create an ad group inside an existing campaign
adGroups.create
- UpdateDestructive
Change an ad group's name, status or default CPC bid, which can change spend; updateMask names the fields that change
adGroups.update
Campaign Budgets
- CreateWrite
Create a campaign budget in micros of the account currency
campaignBudgets.create
- UpdateDestructive
Change a budget amount or name, which changes how much the campaigns using it can spend
campaignBudgets.update
Customers
- List AccessibleRead-only
List the accounts the credentials can call, which is how a caller finds a customer ID
customers.listAccessible
- UpdateWrite
Update the account record itself: auto-tagging, final URL suffix and call reporting
customers.update
Google Ads Fields
- SearchRead-only
Search the queryable fields, which is how a caller finds what a GAQL statement may select
googleAdsFields.search
Connect Google Ads to Claude, ChatGPT or Cursor
- 1
Connect Google Ads in Corsair
Sign in to Google Ads once in Corsair. Corsair stores the credential encrypted and makes the Google Ads API calls for your agent, so it never goes into a prompt or a config file. Connect Google Ads
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Google Ads. On a ChatGPT personal plan, connect Google Ads here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Google Ads's read and write operations run right away and its 6 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/googleads, add the Google Ads plugin, and connect with OAuth. Then call methods like corsair.googleads.api.adGroups.create() from your app. Corsair stores tokens, and keeps each tenant isolated.
Yes. Google Ads needs an OAuth app with scopes that match what you automate. Register the app in Google Ads, configure redirect URLs, then connect through Corsair or managed OAuth in Hub.
Yes. One Corsair client can hit Google Ads, GitHub, Notion, Stripe, and the rest. Trigger Google Ads from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for run Google Ads Query Language reports and manage campaigns, budgets and ad groups through the Google Ads API. Common builds include sync jobs, admin tooling, and agents that call Google Ads APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Google Ads API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/googleads in the open repo. When Google Ads ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Google Ads data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Google Ads data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Google Ads on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 6 destructive Google Ads operations. You can change a link's mode at hub.corsair.dev/me.