Is this the official Google Ads MCP server?

No. Google publishes its own open-source Google Ads MCP server, which you run on your computer or host yourself and which is read-only. InsightfulPipe is an independent, hosted server that connects to the official Google Ads API and also supports write actions. InsightfulPipe is not affiliated with Google.

Which AI assistants does it work with?

Any AI client that supports remote MCP servers. The setup guide on this page covers Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex. You can also work with the same connected accounts from the terminal with the InsightfulPipe CLI.

Is there a Claude connector for Google Ads?

Yes. In Claude, add https://google-ads.insightfulmcp.com/ as a custom connector and authorize your InsightfulPipe account. You can also add InsightfulPipe from the Claude Directory, which connects all of your linked accounts at once.

Can I use the Google Ads MCP server with ChatGPT?

Yes. Add the server URL as a custom connector in ChatGPT Developer mode, or add InsightfulPipe from the ChatGPT app directory to connect all of your linked accounts. Developer mode availability depends on your ChatGPT plan.

What Google Ads data can my AI access?

Anything you can query with the Google Ads Query Language (GAQL): campaigns, ad groups, ads, keywords, search terms, audiences, geographic and device performance, shopping performance, bidding, budgets, labels and change history. Keyword Planner ideas and geo target suggestions are available too.

Can it create and change Google Ads campaigns?

Yes, on accounts connected with Read & Write access. It can create Search, Display, Performance Max, Dynamic Search Ads and App campaigns, ad groups and ads, and manage keywords, negative keywords, targeting, assets, Customer Match lists, conversion actions and labels. New campaigns, ad groups and ads are created paused.

Can I manage multiple Google Ads accounts or an MCC?

Yes. Connect a manager (MCC) account and choose the client accounts to add, or connect accounts one by one. Each connected account counts as one connection on your plan, and your assistant can compare performance across them in one conversation.

Do I need a developer token or a Google Cloud project?

No. You sign in with Google and choose accounts, and InsightfulPipe handles Google Ads API access for the hosted server. You only need your own Google Cloud project if you run Google's open-source server yourself.

Which campaign types are supported?

Reporting covers every campaign type the Google Ads API returns. Creation is supported for Search, Display, Performance Max, Dynamic Search Ads and App campaigns. Video and Demand Gen ads, and Smart, Local, Hotel and Travel campaigns, cannot be created through the server.

How does authentication work?

You connect Google Ads to InsightfulPipe with Google OAuth. Your AI client then signs in to the MCP server with your InsightfulPipe account and receives an InsightfulPipe access token, not your Google login. You can disconnect an account in InsightfulPipe at any time.

How much does the Google Ads MCP server cost?

The Google Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month with a 7-day free trial. See insightfulpipe.com/pricing for current plans.

Google Ads MCPAdvertising87 actions

Google Ads MCP Server

Let your AI agents run Google Ads for you, safely.

A hosted Google Ads MCP server for Claude, ChatGPT, Cursor and CLI agents. Sign in with Google, paste one server URL, then run any GAQL report, research keywords and build campaigns that start paused. Nothing to install.

Enable or disable every action, per account. Block your agent from doing dangerous actions.
Ask in plain English. Create campaigns, pull reports, find insights and take action in Google Ads.
87 read and write actions. Every Google Ads task your agent needs, from reporting to campaign management.
Built for teams. Invite your team and share one connected account.

Start free trial View all 87 actions

Works with

ChatGPT

Claude

Claude Code

Codex

Gemini CLI

Cursor

Mistral

OpenClaw

HermesPerplexityGrokn8nWindsurfVS CodeZed

ChatGPT

connected to Google Ads MCP

Online

Actions

Available Actions

87 actions available to automate your Google Ads workflows.

87 actions

Write

Add Audience Targeting

Target a user list (remarketing audience) with an ad group

Write

Add Call Asset

Add a phone call asset to the account (shows phone number with ads)

Write

Add Callout Asset

Add callout text snippets to a campaign (e.g., 'Free Shipping', '24/7 Support')

Write

Add Demographic Targeting

Add age and/or gender demographic targeting to an ad group

Write

Add Dsa Webpage Targeting

Add a webpage-targeting criterion to a DSA ad group (incl. page-feed label targeting)

Write

Add Keywords

Add keywords to an ad group

Write

Add Label

Create a new label for organizing campaigns, ad groups, and ads

Write

Add Lead Form Asset

Add a lead form to a campaign (users submit info directly from the ad)

Write

Add Location Targeting

Add geographic location targeting to a campaign (countries, cities, postal codes, regions)

Write

Add Negative Keywords

Add negative keywords at campaign or ad group level

Write

Add Price Asset

Add a price asset to the account (shows product/service pricing under ads)

Write

Add Proximity Targeting

Add radius/proximity targeting to a campaign (target users within a radius around coordinates)

Write

Add Sitelinks

Add sitelink assets to a campaign (clickable links below the ad)

Write

Add Structured Snippet Asset

Add a structured snippet to a campaign (category-based highlights)

Write

Apply Label

Apply a label to campaigns, ad groups, or ads

Write

Attach Conversion Actions To Campaign

Bind specific conversion actions to an App campaign via Campaign.selective_optimization. Overrides the customer-level conversion goals for this campaign. App campaigns only.

Write

Create Ad Group

Create a new ad group (always created as PAUSED)

Write

Create App Ad

Create an App ad in an existing App campaign ad group

Write

Create App Campaign

Create an App campaign with its initial App ad group (always created as PAUSED)

Write

Create App Deep Link Asset

Create an app deep link asset for App ads

Write

Create Asset Group

Add an asset group to an existing Performance Max campaign

Write

Create Campaign

Create a new campaign (always created as PAUSED)

Write

Create Conversion Action

Create a conversion action to track valuable user actions

Write

Create Display Campaign

Create a Display campaign with ad group and responsive display ad in one atomic request

Write

Create Dsa Campaign

Create a Dynamic Search Ads (DSA) Search campaign (always created as PAUSED)

Write

Create Dynamic Search Ad

Create a Dynamic Search Ad in a DSA ad group (always created as PAUSED)

Write

Create Page Feed

Create a DSA page feed (AssetSet of type PAGE_FEED) with page URLs and labels

Write

Create Performance Max Campaign

Create a Performance Max campaign with asset group in one atomic request

Write

Create Responsive Display Ad

Create a responsive display ad (always created as PAUSED)

Write

Create Responsive Search Ad

Create a responsive search ad (always created as PAUSED)

Write

Create Search Campaign

Create a new Search campaign (always created as PAUSED)

Write

Create User List

Create a new user list (remarketing audience) for Customer Match

Write

Create Youtube Video Asset

Create a reusable YouTube video asset by video ID

Read

Gaql

Execute a GAQL (Google Ads Query Language) query

Read

Generate Keyword Ideas

Generate keyword ideas from seed keywords or URL using Keyword Planner

Read

Get Account Info

Customer account information and settings

Read

Get Ad Group Bidding

Ad group bidding strategy information

Read

Get Ad Group Labels

Ad group label associations

Read

Get Ad Groups

Ad group performance data and configuration

Read

Get Ad Labels

Ad group ad label associations

Read

Get Ads

Ad creative performance data and policy information

Read

Get Audiences

Audience targeting and demographic performance data

Read

Get Campaign Bidding

Campaign bidding strategy configurations

Read

Get Campaign Budgets

Campaign budget configuration and recommendations

Read

Get Campaign Labels

Campaign label associations

Read

Get Campaigns

Campaign performance data and configuration

Read

Get Change History

Change status history for Google Ads entities

Read

Get Clicks

Click-level performance and location data

Read

Get Client Accounts

Customer client hierarchy and management information

Read

Get Criterion Labels

Ad group criterion label associations

Read

Get Customer Labels

Customer label associations

Read

Get Display Keywords

Display keyword targeting performance

Read

Get Geo Performance

Geographic and location-based performance data

Read

Get Keywords

Keyword performance data and statistics

Read

Get Labels

Label management and organization data

Read

Get Non Manager Accounts

Customer client non-manager accounts only

Read

Get Shopping Performance

Shopping campaign product-level performance data

Read

Get Topics

Topic targeting performance data

Read

Get User Interests

User interest categories and availability

Read

Get User Locations

User location-based performance data

Write

Link Asset Group Assets

Attach existing assets to a Performance Max asset group

Write

Link Page Feed To Campaign

Link a page-feed asset set to a DSA campaign (CampaignAssetSet)

Write

Pause Ad

Pause an individual ad

Write

Pause Ad Group

Pause an ad group

Write

Remove Customer List Members

Remove members from a Customer Match user list

Write

Remove Keywords

Remove keywords from an ad group

Write

Remove Negative Keywords

Remove negative keywords at campaign or ad group level

Write

Resume Ad

Resume (enable) a paused ad

Write

Resume Ad Group

Resume (enable) a paused ad group

Write

Set Asset Group Listing Filters

Choose which Merchant Center products a Performance Max asset group advertises

Write

Set Campaign Device Targeting

Target or exclude a device for a whole campaign, including Demand Gen

Write

Set Device Bid Modifier

Set bid adjustment for a specific device type on an ad group

Read

Suggest Geo Targets

Search for geo target constants by name (city, postal code, region) to get IDs for location targeting

Write

Unlink Asset Group Assets

Detach assets from a Performance Max asset group

Write

Update Ad

Update an ad's status (enabled, paused, removed)

Write

Update Ad Group

Update an ad group: name, bids, targets, rotation, URL settings, or status (enabled, paused, removed)

Write

Update App Ad

Update an existing App ad's inline text and referenced assets

Write

Update Asset Group

Update a Performance Max asset group: name, landing pages, or status (enabled, paused, removed)

Write

Update Asset Group Signals

Add or remove audience and search theme signals on an existing asset group

Write

Update Campaign

Update a campaign: name, dates, budget, bid targets, URL settings, or status (enabled, paused, removed)

Write

Update Conversion Action

Update an existing conversion action's settings

Write

Update Keywords

Update existing keywords (status, bids)

Write

Update Responsive Search Ad

Update an existing responsive search ad's headlines, descriptions, or URLs

Write

Upload Click Conversions

Upload offline click conversions (Enhanced Conversions for Leads)

Write

Upload Customer List

Upload members to a Customer Match user list (remarketing audience)

Write

Upload Image Asset

Upload an image asset from a URL to Google Ads

Write

Upload Media Bundle Asset

Upload an HTML5 media bundle asset from a ZIP URL

Compare

Google Ads MCP servers compared: hosted vs official

Google publishes an open-source Google Ads MCP server. It is a good fit if you want a free, read-only tool that you run and maintain yourself. InsightfulPipe is a hosted alternative for teams that want write actions, quick setup in any AI client and account-level controls.

What you operate	InsightfulPipe MCP server	Google Ads MCP (Google, open source)
Hosting	Hosted by InsightfulPipe: paste one URL	Runs on your computer with pipx and Python 3.10+, or on infrastructure you host such as Cloud Run
Setup	Sign in with Google and choose accounts	Google Cloud project with the Google Ads API enabled, OAuth credentials and an approved API access level
Read or write	Read and write: 87 actions, 59 of them write	Read-only
Tools	GAQL, Keyword Planner and geo targets, plus campaign, ad group, ad, keyword, asset, audience, conversion and label actions	3 tools: search (GAQL), get_resource_metadata and list_accessible_customers
Manager (MCC) accounts	Connect a manager account and pick client accounts	Supported with a login customer ID setting
Safety controls	Per-account action controls, Read-only connections, destructive actions off by default, new campaigns paused	Tools can be turned on or off in a config file
Other platforms	Meta Ads, GA4, LinkedIn Ads and 40+ more MCP servers, plus a CLI	Google Ads only
Price	Included in plans from $29.99/month, with a 7-day free trial	Free and open source (Apache-2.0)

Overview

What you can do with the Google Ads MCP

The InsightfulPipe Google Ads MCP server is a hosted Model Context Protocol server that connects your Google Ads accounts to AI assistants such as Claude, ChatGPT, Cursor, Claude Code, Gemini CLI and Codex. You sign in with Google, choose the accounts to connect and paste one server URL into your AI client.

Claude

Acme StoreRead-only

Ask about your Google Ads account…

01Reporting

Analyze your Google Ads in seconds

Ask for any report in plain English. The assistant writes the GAQL query, runs it and explains what is working, what is wasting spend and what to fix next.

Campaign, ad group, keyword and search term reports
Cost, conversions, ROAS, CPA and budget pacing
One question across every client account in an MCC

See the read actions

Claude

Acme StoreRead & Write

Ask about your Google Ads account…

02Keywords

Manage keywords in bulk

Tell it to pause losers, add negatives after a search term review or adjust bids across campaigns. It only uses the write actions you have enabled for that account.

Add, pause and update keywords across ad groups
Turn wasted search terms into negatives in one step
Bid changes with the before and after shown

See the write actions

Claude

Acme StoreRead & Write

Ask about your Google Ads account…

03Campaigns

Build campaigns that start paused

Create Search, Performance Max, Display and App campaigns with ad groups, ads and assets from one prompt. New campaigns, ad groups and ads start paused, so nothing spends until you say so.

Campaign, ad groups, ads and keywords in one go
Sitelinks, callouts and other assets attached
New campaigns, ad groups and ads start paused

How action controls work

actions

one server URL

read actions

reports, audits, research

write actions

create, update, manage

Setup

How to connect the Google Ads MCP server

Add the server URL to your AI client, then sign in with your InsightfulPipe account to authorize access. The server is hosted, so there is nothing to install.

MCP server URL

https://google-ads.insightfulmcp.com/

Connect Google Ads to Claude

Fastest: add InsightfulPipe from the Claude Directory

One click connects the full InsightfulPipe MCP with all your connected accounts. To add a server scoped to Google Ads only, follow the steps below.

Open Claude Directory

Or add the Google Ads server manually:

01
Copy the server URL:
```
https://google-ads.insightfulmcp.com/
```
02
Open Claude connector settings (Customize > Connectors), click + and then Add custom connector.
03
Paste the URL and click Add.
04
Click Connect, then click Authorize access in the browser.

Start a new chat, click +, open Connectors and turn the connector on to use it.

The Free plan can add one custom connector. On Team and Enterprise plans, an Owner first adds it under Organization settings > Connectors, then each member clicks Connect in Customize > Connectors.

Connect Google Ads to ChatGPT

Fastest: add InsightfulPipe from the ChatGPT app directory

One click connects the full InsightfulPipe MCP with all your connected accounts. To add a server scoped to Google Ads only, follow the steps below.

Open in ChatGPT

Or add the Google Ads server manually. Custom MCP servers need ChatGPT's Developer mode, which OpenAI offers on Plus, Pro, Business, Enterprise and Education accounts on the web.

01
Copy the server URL:
```
https://google-ads.insightfulmcp.com/
```
02
In ChatGPT, open Settings → Security and login and turn on Developer mode.
03
Go to ChatGPT Plugins and select the + button.
04
Enter a name, paste the URL under Connection and create the connection.
05
When the sign-in opens, click Authorize access in the browser.
06
In a new chat, choose Developer mode from the + menu and select the app. Select it again in each new chat.

See OpenAI's Developer mode guide.

Connect Google Ads to Claude Code

Add the server:

claude mcp add --transport http google-ads-mcp https://google-ads.insightfulmcp.com/

02
In Claude Code, run /mcp, select google-ads-mcp and choose Authenticate.
03
Sign in to InsightfulPipe in the browser window and click Authorize access.

Connect Google Ads to Cursor

01
Add the Google Ads MCP server to Cursor, or add it to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
```
{
  "mcpServers": {
    "google-ads-mcp": {
      "url": "https://google-ads.insightfulmcp.com/"
    }
  }
}
```
02
The server shows Needs authentication. Click Connect, then Open.
03
Sign in to InsightfulPipe and click Authorize access.

Connect Google Ads to Gemini CLI

Add the server:

gemini mcp add --transport http google-ads-mcp https://google-ads.insightfulmcp.com/

02
In Gemini CLI, run /mcp auth google-ads-mcp.
03
Sign in to InsightfulPipe in the browser window and click Authorize access.

Connect Google Ads to Codex CLI

Using the Codex app? Add InsightfulPipe from the OpenAI app directory

The listed app connects the full InsightfulPipe MCP with all your connected accounts, in both ChatGPT and Codex.

Open the app listing

01
Add the server. When Codex detects OAuth support, it starts sign-in right away:
```
codex mcp add google-ads-mcp --url https://google-ads.insightfulmcp.com/
```
02
A browser window opens. Sign in to InsightfulPipe and click Authorize access. If no browser opens, run codex mcp login google-ads-mcp.

Watch the setup tutorial

Works everywhere

Bring Google Ads into the AI tools you already use

One hosted server URL, any MCP-compatible client. Pick yours to see the setup steps, or paste the URL into anything that speaks MCP.

Playbook

Prompts and skills that run on the Google Ads MCP

Copy a prompt into any connected client, or install a Claude skill that chains the actions for you.

Prompt

“What was my ROAS by campaign over the last 30 days?”

Pulls cost and conversion value per campaign with GAQL

View prompt

Skill

Google Ads A/B Test Designer

Claude skill that designs Google Ads A/B tests with a hypothesis, sample size, test duration and success criteria before you change ads, bids or pages.

Download View skill

Prompt

“Which search terms spent more than $50 without a conversion last month?”

Finds negative keyword candidates

View prompt

Skill

Ad Copy Performance Ranker

Claude skill that ranks Google Ads responsive search ads by CTR and conversion rate, finds winning headline patterns and flags weak ads to rewrite.

Download View skill

Prompt

“Generate 30 keyword ideas for ‘running shoes’ in the United States”

Uses Keyword Planner ideas with volume and competition

View prompt

Skill

Bid Strategy Auditor

Claude skill that checks whether your Google Ads bid strategy fits your conversion volume, compares it with alternatives and recommends when to switch.

Download View skill

Prompt

“Which campaigns are limited by budget this week?”

Checks budget pacing and campaign status

View prompt

Skill

Budget Allocation Optimizer

Claude skill that uses marginal CPA analysis to show how much Google Ads budget to move between campaigns and the expected impact of each change.

Download View skill

Prompt

“Create a paused Search campaign for our spring sale with a $50 daily budget”

Builds the campaign paused for review

View prompt

Browse the prompt library All Claude skills

HAVE QUESTIONS?

Frequently asked questions

A Google Ads MCP server connects Google Ads to AI assistants through the Model Context Protocol (MCP), an open standard for giving AI tools access to data and actions. Once connected, you can ask Claude, ChatGPT or Cursor about campaign performance and ask it to make changes, instead of clicking through the Google Ads interface.

Google's server runs locally or on infrastructure you host, needs a Google Cloud project with an approved Google Ads API access level, and offers three read-only tools: search, get_resource_metadata and list_accessible_customers. InsightfulPipe is hosted, needs only a Google sign-in, and adds write actions such as creating campaigns, ads and keywords, plus per-account action controls and team access.

You control the risk. New campaigns, ad groups and ads start paused. You can connect accounts as Read-only, and on Read & Write accounts you choose exactly which actions your AI can use. Removal actions such as removing keywords stay off until an owner, admin or operator enables them. Enabling or removing a campaign through a status update is a regular write action, so turn off the update actions for any account where agents should not change what is live.