← All integrations

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.

Runs once, when you ask

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

Connect Google Ads to Claude, ChatGPT or Cursor

  1. 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. 2

    Add Corsair's MCP server to your agent

    Every client uses the same address:

    https://mcp.corsair.dev/mcp
    Open Customize → Connectors → Add custom connector, paste the address, then select Connect.

    Codex, 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. 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.