Skip to content
← Guides

Google Ads MCP server: Google's official one, and a faster way into Claude and ChatGPT

Google's Google Ads MCP server needs Python, a Cloud project and OAuth setup. HeyMetra connects Google Ads to Claude and ChatGPT with a Google sign-in.

The HeyMetra Team Updated 5 min read

Key takeaways

  • Yes, Google publishes an official Google Ads MCP server, googleads/google-ads-mcp. It runs on your computer and needs Python, a Google Cloud project with the Google Ads API switched on, and OAuth credentials.
  • Claude on the web and ChatGPT can only use Google's server after you deploy it yourself, for example on Cloud Run with your own OAuth client.
  • HeyMetra connects Google Ads in a few minutes: sign in with the Google account that sees the ads, pick the client account, and add one address to Claude, ChatGPT or any other AI assistant you use.
  • GA4, Search Console, WooCommerce and Amazon Seller Central connect to the same address, so one question can set Google Ads spend beside the orders it brought.
  • Changes are optional. When you connect, you choose whether your AI assistant may propose them, such as pausing a campaign, and nothing is sent until you approve it.

Yes, Google publishes an official Google Ads MCP server, the piece that lets an AI assistant read your ad account. Setting it up takes Python, a Google Cloud project and OAuth credentials, and it runs on your own computer. If you would rather ask Claude or ChatGPT where your budget went a few minutes from now, HeyMetra connects Google Ads with a Google sign-in and one address, next to your store and your analytics. This guide covers both.

Is there an official Google Ads MCP server?

Yes. Google publishes googleads/google-ads-mcp under the Apache 2.0 license, with about 1,100 stars on GitHub. Google’s documentation describes the current release as read-only: it lists the accounts you can reach and runs reports written in GAQL, Google Ads’ own query language. The code on GitHub also includes tools for creating assets and managing labels, switched on unless you turn them off, each with a confirmation step.

It reads Google Ads alone. Whether the clicks turned into orders is in your store, and what visitors did on the site is in GA4. Google’s server reads neither.

Connect Google Ads to Claude or ChatGPT in a few minutes

HeyMetra’s Google Ads connector, in beta, runs on our servers, so there is nothing to install:

  1. Sign in with Google. In HeyMetra, choose Google Ads and sign in with the Google account that can already open the ads in Google Ads. Your password stays with Google.
  2. Pick the client account. If you work through a manager account, pick the client account that holds the campaigns. Here you also choose whether your AI assistant may propose changes.
  3. Add HeyMetra to your AI assistant. Add https://mcp.heymetra.com/mcp as a custom connector in Claude, or in ChatGPT’s developer mode. In Claude Code it is one command.

If you allowed changes, your AI assistant can pause or resume a campaign or change its daily budget. It writes out the exact change in the chat and waits, and nothing reaches Google Ads until you approve it.

The same address works in Claude, ChatGPT, Grok, Perplexity, Claude Code, Codex, Cursor and Antigravity, and your team shares one connection. Every plan starts with a seven-day free trial.

What Google’s own server takes to set up

Before your first question, Google’s server asks you to:

  1. Install Python’s pipx on your computer.
  2. Create a Google Cloud project, switch on the Google Ads API, and make sure the project has API access.
  3. Create an OAuth client, or sign in with gcloud using the Google Ads scope, so the server has credentials on your machine.
  4. Add the server to your AI assistant’s config file with the credentials path and project ID, plus your manager account’s ID if you reach the ads through one.

It then runs in apps that start programs on your computer, such as Claude Code, Codex, Cursor and Antigravity. Claude on the web and ChatGPT reach servers from their own cloud, so they can use Google’s server only after you deploy it on Cloud Run with your own OAuth client and keep it running. Google stopped requiring a developer token in September 2026, which removed one step.

HeyMetra Google’s google-ads-mcp
Setup Sign in with Google, pick the account, add one address Python, Cloud project, Google Ads API, OAuth client, config
Claude on the web and mobile, ChatGPT Yes Only after you deploy it yourself
Team One connection for everyone Each person installs their own
Other accounts in the same question GA4, Search Console, your store and more Google Ads only
Changes to campaigns Pause, resume and daily budget, each one approved by you Read-only in the documented release
Cost Subscription, seven-day free trial Free, plus setup and hosting time

Google’s server suits a developer who writes GAQL and wants Google Ads in a terminal. If your questions reach past Google Ads, or you want to ask from Claude or ChatGPT on the web, HeyMetra is the shorter path.

Here is a question in Claude that reads Google Ads and WooCommerce at once, for an online coffee shop:

Claude
Google Ads says our campaigns brought 212 conversions last month. How many WooCommerce orders actually came from Google Ads, and what did they bring after refunds?
Read Google Ads and WooCommerce with HeyMetra
WooCommerce has 164 orders tagged google / cpc last month, worth $14,300 after $610 in refunds. Google Ads reports 212 conversions worth $18,900. Most of the gap is Performance Max: it counts 71 conversions, while WooCommerce has 29 orders from it. Google Ads also counts conversions from people who saw an ad and bought later.
WooCommerce orders by campaign, last month
Search: coffee beans81Search: brand54Performance Max29
Reply to Claude…

ChatGPT uses the same connection. Here it reads the searches you paid for:

ChatGPT
Which search terms did we pay for in the last 30 days without a single conversion?
Used HeyMetra · Google Ads
38 search terms cost $1,240 with no conversion. The top four are $690 of that, and two of them come from people looking for a café nearby. Adding those two as negative keywords in Google Ads would stop that spend.
Search termCostClicks
coffee shop near me$310204
espresso machine repair$16088
cafe open now$13097
free coffee samples$9071
Ask anything

Grok puts the campaigns next to what GA4 saw on the site:

Grok
Which of our Google Ads campaigns bring visitors who leave right away?
Read Google Ads and Google Analytics with HeyMetra
Performance Max brought the most sessions last month, 6,800, but only 31% of them were engaged, against 68% for the coffee beans search campaign. Most of its sessions land on the home page from display placements; the search campaigns land on product pages.
Sessions by campaign, last month
Performance Max6,800Search: coffee beans3,900Search: brand2,100
What do you want to know?

Google Ads keeps attributing conversions for a few days after a click, so the newest days are not final, and your AI assistant says so. A few more that work well:

  • Which campaigns spent in the last 30 days without a single conversion?
  • How did return on ad spend move week by week this quarter, and in which week did cost per conversion jump?
  • Which search queries get clicks from ads and from organic results in Search Console at the same time?
  • Which product categories sell well in WooCommerce but get almost none of the ad spend?

Accounts that connect to the same place

Google Ads is one of more than twenty accounts HeyMetra connects, each with its own sign-in or key:

You add HeyMetra to your AI assistant once. Each account you connect afterwards answers through the same address.

  • #google-ads
  • #mcp
  • #claude
  • #chatgpt
  • #ppc

Frequently asked questions

Is there an official Google Ads MCP server?

Yes. Google publishes googleads/google-ads-mcp on GitHub. Google's documentation describes the current release as read-only: it lists your accounts and runs reports written in GAQL, Google Ads' query language. You install it on your computer or deploy it yourself on Google Cloud.

How do I connect Google Ads to Claude?

With HeyMetra: choose Google Ads, sign in with the Google account that can open the ads, and pick the client account. Then add HeyMetra's address, https://mcp.heymetra.com/mcp, to Claude as a custom connector. It works in Claude on the web, desktop and mobile.

Can I connect Google Ads to ChatGPT?

Yes. Add HeyMetra's address to ChatGPT in developer mode and Google Ads answers there, along with every other account you connected. Google's own server works in ChatGPT only after you host it on a public address with sign-in.

Does it work with a manager account (MCC)?

Yes. Sign in with a Google account that reaches the manager account and pick the client account whose campaigns you want to ask about. Each client account is its own connection.

Can the AI assistant pause campaigns or change budgets?

Only if you allow changes when you connect. Your AI assistant can then propose pausing or resuming a campaign or changing its daily budget, with the exact change written out, and nothing is sent to Google Ads until you approve it.

Your competitors already put AI to work. Start with the account you check every day.

Add it to HeyMetra once, then ask about it in the AI assistant you already pay for. Add the next one when you need it.