Claude Code updates frequently and steps may change. Running into issues? Chat with us in the bottom right, we're happy to help!
A free tool by TrueClicks · Not affiliated with Anthropic

What Claude Code Did for Software, It Can Do for Google Ads.

The AI revolution that transformed software development is here for PPC. Analyze, optimize, and manage your Google Ads through natural conversation with the world's most intelligent AI - Claude Code.

Claude Code for Google Ads - account audit scorecard
Getting Started

From Question to Optimization in Minutes

No complex setup. Just connect and start optimizing.

01

Connect Your Account

Install Claude Code, add the Google Ads plugin, and connect your credentials. Takes less than 5 minutes.

02

Ask Anything

Ask questions about your account in natural language. Claude downloads your data, analyzes performance, and gives you actionable insights.

03

Optimize with Confidence

Request changes, review them before they go live, and apply with one click. Every change is validated and saved automatically.

What Can You Ask?

Describe It. Review It. Done.

No scripts. No spreadsheets. Just describe what you need in plain language.

Ask

Why Claude Code?

Not Just Another AI Chat

Claude Code for Google Ads is a free solution that turns a state-of-the-art AI agent into a full Google Ads specialist.

Truly Agentic - Not Just Answers

Most AI tools respond. Claude Code acts. It plans multi-step analyses, spins up subagents to run tasks in parallel, iterates on its own outputs, and chains everything into a final result - autonomously, without you steering every step.

Local-First, Not Context-Stuffed

Regular AI chats need all your data pasted in upfront - burning through context and losing accuracy fast. Claude Code works from your local filesystem, reading only what it needs for each task. No bloated context, no stale exports.

Not Just Analysis - Execution

Claude Code for Google Ads creates campaigns, pauses keywords, adds negatives - real changes, not just recommendations. Claude plans, you approve, our backend executes. Nothing touches your account without your say-so - and every change is validated.

How It Works

Under the Hood

From data download to change execution - here's what happens step by step.

1

Claude Code integration downloads all account essentials - campaigns, ad groups, ads, keywords, negatives, extensions, and more - alongside performance metrics, to a local filesystem.

2

The data is organized in a local folder structure mirroring Google Ads' hierarchy: campaigns and ad groups become folders, with ads, keywords, and extensions as files within them. All outside the AI's context window.

3

Running /google-ads:get explicitly fetches the latest data directly from Google Ads to your local filesystem - so you're always working with the latest account state.

4

Claude Code reads only the folders and files it needs for a given task, enabling fast analysis without burning through tokens and cluttering the context window. When it needs data not stored locally, it queries the Google Ads API directly.

5

When it comes to making changes, the AI never makes changes in Google Ads directly - that would be unpredictable, risky, and even harder to revert mistakes. Instead, it plans changes and writes them to a local file - pending_changes.json - a structured file for every planned operation.

6

Running /google-ads:validate-changes checks every planned change in the JSON file against Google Ads rules - character limits, RSA description lengths, policy requirements, and more - and performs a dry run to catch issues before anything goes live.

7

Any validation failures are automatically sent back to Claude Code for self-correction, keeping the reliability loop entirely outside manual intervention.

8

Running /google-ads:execute-changes applies the approved planned changes from the JSON file in Google Ads programmatically - completely outside AI - so every action is predictable, auditable, and fully under your control.

9

Finally, every executed change is logged to a local change-history folder - giving you a full audit trail to review what changed, when, and why, and making it easy to reference or revert any past action.

Set Up in Under 5 Minutes

Two parts: install the tools, then connect your Google Ads account.

Part 1: Installation

1

Use the Console to install

As of April 2025, plugins can no longer be added directly from the Desktop app. You'll need to install the plugin through the console instead — don't worry, it's quick and easy, and the plugin will automatically become available in your Desktop app too.

Switch to the Console tab above to follow the installation steps.

Overall, we recommend using the console for Claude Code — it's not as intimidating as it sounds and gives you the most reliable experience.

Part 2: Configuration

1

Create config.json

Click Get GPT Token below to sign in with your Google account, select your MCC and Google Ads account, then download the config.json file.

Each config file is tied to a single Google Ads account and contains a GPT token that connects Claude Code to the Google Ads account through our secure backend. Managing multiple accounts? Just create a separate config for each one.

2

Place config.json in Google Ads folder

Create a folder for the Google Ads account on your disk and move the downloaded config.json into it. This folder will be your working directory for Claude Code.

The config file is stored locally and never leaves your machine. You only need to do this once per account.

3

Start managing your account

In the Claude desktop app, switch to the Code tab, select the folder containing your config.json, then run /google-ads:get to download your account data and start asking questions.

Try: “Analyze my Google Ads account and find optimization opportunities.”

Frequently Asked Questions

Everything you need to know about Claude Code for Google Ads.

Start Optimizing Your Google Ads Today

Requires a Claude subscription (starting at $20/month). No additional fees.