> For the complete documentation index, see [llms.txt](https://docs.allmcp.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allmcp.co/documentation/providers/google-ads.md).
# Google Ads
Connect Google Ads to manage campaigns, target keywords, pull performance metrics, upload offline conversions, get optimization recommendations, and run Performance Max and Demand Gen — all by talking to your agent.
All providersHow connecting works
***
## Point your client at AllMCP
Connect your MCP client to the AllMCP endpoint and authenticate with your API key.
```
https://go.allmcp.co/mcp/
```
Send your key on every request using either header:
```
X-API-Key: allmcp_xxx
```
```
Authorization: Bearer allmcp_xxx
```
If you run agents for more than one of your own customers, add `?user_id=...` (and optionally `?org_id=...`) to the endpoint URL so each customer's Google connection stays separate.
***
## Connect
Google Ads connects with your Google account (OAuth2).
{% stepper %}
{% step %}
#### Ask your agent to connect Google Ads
Tell your agent to connect Google Ads. It returns a Google sign-in link.
{% endstep %}
{% step %}
#### Grant access and you're done
Open the link in your browser, sign in, and grant access to your Google Ads account. AllMCP handles the consent flow and keeps your connection refreshed for you.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
You don't need a personal Google Ads developer token. Just connect your Google account and you're ready to go.
{% endhint %}
***
## Tools by category
Once Google Ads is connected, your agent can use the tools below. You don't need to memorize them — just describe what you want in plain language and your agent picks the right tool.
### Campaigns
| Tool | Description |
| ----------------------------------- | ---------------------------------------------------------- |
| `google_ads_list_campaigns` | Lists your campaigns with their current status and budget. |
| `google_ads_get_campaign` | Shows the full details of one campaign by its ID. |
| `google_ads_create_campaign` | Creates a new campaign in your account. |
| `google_ads_update_campaign_status` | Pauses, enables, or removes a campaign. |
| `google_ads_delete_campaign` | Permanently deletes a campaign. |
### Metrics
| Tool | Description |
| --------------------------------- | ----------------------------------------------------------------------------- |
| `google_ads_run_gaql` | Runs a custom Google Ads Query Language (GAQL) query for any report you need. |
| `google_ads_get_campaign_metrics` | Returns clicks, impressions, cost, and conversions for your campaigns. |
| `google_ads_get_ad_group_metrics` | Returns performance figures broken down by ad group. |
| `google_ads_get_keyword_metrics` | Returns performance figures broken down by keyword. |
### Accounts
| Tool | Description |
| -------------------------------------- | -------------------------------------------------------------- |
| `google_ads_list_accessible_customers` | Lists every Google Ads account your connected login can reach. |
| `google_ads_get_customer` | Shows the details of a specific Google Ads account. |
| `google_ads_list_customer_hierarchy` | Maps out the manager (MCC) account and its child accounts. |
### Ad Groups
Create and list ad groups; create responsive search ads.
### Keywords
Add and list keywords and negative keywords.
### Budgets & Bidding
Create and update campaign budgets and bidding strategies.
### Conversions
List conversion actions, upload offline click/call conversions.
### Diagnostics
AI-driven account analysis, recommendations, and applying recommendations.
| Tool | Description |
| --------------------------------- | -------------------------------------------------------------------- |
| `google_ads_diagnose_account` | Reviews your account and flags issues and improvement opportunities. |
| `google_ads_get_recommendations` | Returns Google's suggested optimizations for your account. |
| `google_ads_apply_recommendation` | Applies a specific recommendation by its ID. |
### Assets
Sitelinks, callouts, and structured-snippet creative assets.
### Audiences
User-list audiences and audience-targeting application.
### Performance Max
| Tool | Description |
| ------------------------------------------- | -------------------------------------------------------------------- |
| `google_ads_list_pmax_search_term_insights` | Shows the search-term categories driving a Performance Max campaign. |
| `google_ads_add_pmax_gender_exclusion` | Excludes a gender from a Performance Max campaign's targeting. |
### Demand Gen
| Tool | Description |
| ------------------------------------------ | --------------------------------------------------------------------------- |
| `google_ads_create_demand_gen_image_asset` | Uploads a logo or marketing image from a web URL for use in Demand Gen ads. |
| `google_ads_attach_demand_gen_asset` | Attaches an uploaded image to a Demand Gen asset group. |
You can also create Demand Gen campaigns through the campaign tools — just ask your agent to set one up.
***
## Common workflows
{% tabs %}
{% tab title="Performance snapshot" %}
```
Get last week's campaign metrics — clicks, impressions, cost, and conversions — for all active campaigns
```
{% endtab %}
{% tab title="Pause underperforming campaigns" %}
```
List all campaigns with a cost-per-conversion above $50 last month and pause them
```
{% endtab %}
{% tab title="Keyword research" %}
```
List all keywords in campaign ID 123 with their average CPC and conversion rate
```
{% endtab %}
{% tab title="Custom GAQL query" %}
```
Run this GAQL: SELECT campaign.name, metrics.clicks, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_7_DAYS
```
{% endtab %}
{% endtabs %}
***
## Notes
{% hint style="warning" %}
* You can give your agent a customer ID in either form — `123-456-7890` or `1234567890` — both work.
* If you manage several accounts under a manager (MCC) account, tell your agent which child account to work on.
* Need a report that isn't covered by the standard metrics tools? Ask your agent to run a custom Google Ads Query Language (GAQL) query.
{% endhint %}
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.allmcp.co/documentation/providers/google-ads.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.