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:
- 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.
- 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.
- Add HeyMetra to your AI assistant. Add
https://mcp.heymetra.com/mcpas 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:
- Install Python’s
pipxon your computer. - Create a Google Cloud project, switch on the Google Ads API, and make sure the project has API access.
- Create an OAuth client, or sign in with
gcloudusing the Google Ads scope, so the server has credentials on your machine. - 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.
Google Ads next to your store and your analytics
Here is a question in Claude that reads Google Ads and WooCommerce at once, for an online coffee shop:
| Campaign | Google Ads conversions | WooCommerce orders |
|---|---|---|
| Search: coffee beans | 88 | 81 |
| Search: brand | 53 | 54 |
| Performance Max | 71 | 29 |
ChatGPT uses the same connection. Here it reads the searches you paid for:
| Search term | Cost | Clicks |
|---|---|---|
| coffee shop near me | $310 | 204 |
| espresso machine repair | $160 | 88 |
| cafe open now | $130 | 97 |
| free coffee samples | $90 | 71 |
Grok puts the campaigns next to what GA4 saw on the site:
| Campaign | Sessions | Engaged |
|---|---|---|
| Performance Max | 6,800 | 31% |
| Search: coffee beans | 3,900 | 68% |
| Search: brand | 2,100 | 74% |
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:
- Analytics: Google Analytics 4, for what visitors did after the click. Our GA4 guide compares Google’s own server too.
- Search: Google Search Console, for the searches you rank for without paying. See SEO analysis with Claude and Search Console.
- Stores and payments: WooCommerce, Amazon Seller Central and Stripe, for the orders the clicks led to.
- Team: Slack and email, to send what your AI assistant found.
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.