Run Google Ads from Claude Code

Valkiria reads the Google Ads account you connected over Google OAuth and gives the assistant campaigns, dated spend and conversions, the standing audit findings and the care recommendations. Claude Code adds Valkiria with one command. Because it works in your terminal and repository, it can save what it reads to files, compare it with last week and keep reports next to your code.

Checked:

01

Connect Claude Code in 3 steps

  1. Run the command below in your terminal.
  2. Sign in to Valkiria in the browser window that opens and approve the request.
  3. Start a new session and type: "Get started with Valkiria".
  • The command registers a remote HTTP server; nothing is installed locally and no API key is stored in your repository.
Terminal
claude mcp add --transport http valkiria https://valkiria.pro/mcp

02

What works for Google Ads today

Connection: Google OAuth. One authorisation covers Google Ads and Merchant Center; manager accounts (MCC) are supported.

The assistant can read

  • Campaigns with status and budgets, including Search, Performance Max and Shopping.
  • Dated spend, clicks and conversions per currency for an explicit date range, with the time of the last sync.
  • Open findings of the standing campaign audit, by severity, and the review of a single campaign.
  • Care recommendations for a campaign, with a preview of what each one would change.
  • Live from Google: one campaign as a tree of ad groups, ads and keywords; keywords with quality score; the search terms report; negative keywords; ad extensions; Performance Max asset groups with their search themes.
  • Search terms and keywords that spent money without a recorded conversion, impression share and the account change history.

The assistant can propose or request

  • Propose keywords and negative keywords to add or remove, a keyword update, and Performance Max search themes.
  • Propose a campaign budget, a bid strategy, targeting, extensions, a new ad group or a responsive search ad, and a status change for several items at once.
  • Approve or reject a care recommendation. Before it is queued, the change can be checked by Google itself in validate-only mode.
  • Request a pause or a resume of a campaign.
  • Create a campaign draft inside Valkiria. A campaign that later reaches Google is created PAUSED.
  • Create and update automation rules.
  • Create a monitor that checks the account on a schedule and notifies you or queues a proposal, and schedule a report by email. Neither changes an ad account by itself.

Live integration statusGoogle Ads in Valkiria

03

Prompts to try: Google Ads in Claude Code

Copy one, replace the parts in brackets and send it. The assistant picks the tools itself.

  1. Which Search campaigns spent the most in the last 30 days without a single conversion? Show spend in the account currency.

  2. Compare my Performance Max and Search campaigns for the last 14 days: spend, clicks, conversions and cost per conversion.

  3. List the open audit findings for my Google Ads account, blocking ones first, and explain each one in plain language.

  4. Show the care recommendations for my Shopping campaign and what each would change before I decide.

  5. Pull dated Google Ads facts for the last 90 days and write them to reports/google-ads-90d.csv, one row per campaign per day.

  6. Compare this week's Google Ads audit findings with findings/last-week.json in this repo, save the new list and summarise what is new.

04

How changes stay safe

  • Sign-in uses OAuth 2.1 with PKCE on valkiria.pro, so the assistant never sees your password.
  • Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
  • A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
  • New campaigns are created paused. Starting new spend and deleting always wait for a person.
  • The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
  • The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
  • You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.

05

Limits

Google Ads

  • Deleting from the assistant removes a Valkiria draft only, never a campaign in Google Ads.
  • Starting new spend is never done by the assistant: resuming and launching wait for a person.

Claude Code

  • Files the assistant writes are its own work in your repository: Valkiria returns data, it does not create files for you.
  • The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
  • Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
  • Money stays in each account's own currency. Different currencies are not converted or added up.
  • Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.

06

FAQ

Ask Claude Code about your Google Ads account

Create a free account, connect an ad account and add the connector. The first pass only reads.

Drag to move. Alt + arrow keys move the button; Alt + Home resets its position.

Cookie Preferences

We use cookies to enhance your experience. Essential cookies are always active. You can manage optional cookies below.

Essential
Analytics
Marketing
Third-Party