# Google Ads setup > Connect Google Ads to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 38 tools behind the answers. [Guides](https://www.getmcpads.com/guides) ## For you Raw GAQL, search terms, Shopping, Performance Max diagnostics, change history. ## Connect it 1. Open the dashboard and choose this platform. 2. Approve the consent screen. The gateway stores an encrypted refresh token, never a password. 3. Tick the accounts to expose. Nothing is readable until you do. 4. Paste the endpoint into your assistant, or use the shared one for every platform at once. Google Ads on its own endpoint ```text https://mcp.getmcpads.com/google-ads/mcp ``` ## What to ask ```text Which campaigns spend the most and return the least? Show me search terms we paid for that we would never have bid on. Is any Performance Max campaign spending without the ad strength to justify it? Who changed what in the last two weeks? Which Shopping products take spend and return nothing? What would these keywords cost, and how much volume is there? Run this exact GAQL query. ``` ## What answers each one | Question | Tools | | --- | --- | | Which campaigns spend the most and return the least? | [`google_ads_get_insights`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_insights), [`google_ads_get_campaigns`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_campaigns) | | Show me search terms we paid for that we would never have bid on. | [`google_ads_get_search_terms`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_search_terms) | | Is any Performance Max campaign spending without the ad strength to justify it? | [`google_ads_get_pmax_asset_diagnostics`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_pmax_asset_diagnostics), [`google_ads_get_pmax_placements`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_pmax_placements) | | Who changed what in the last two weeks? | [`google_ads_get_change_events`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_change_events) | | Which Shopping products take spend and return nothing? | [`google_ads_get_shopping_performance`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_shopping_performance), [`google_ads_get_shopping_products`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_shopping_products) | | What would these keywords cost, and how much volume is there? | [`google_ads_generate_keyword_ideas`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_generate_keyword_ideas), [`google_ads_generate_keyword_forecast_metrics`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_generate_keyword_forecast_metrics) | | Run this exact GAQL query. | [`google_ads_run_gaql`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_run_gaql), [`google_ads_search_fields`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_search_fields) | ## What it can change Pause, resume or remove a campaign or ad group. Rename a campaign, change its dates, change a daily budget or an ad group CPC bid. Create a campaign, always paused. > **Warning** 7 write tools, absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm before anything changes. - [Google Ads reference](https://www.getmcpads.com/docs/sources/google-ads): All 38 tools, with their parameters. - [Metrics](https://www.getmcpads.com/docs/sources/google-ads/metrics): 130 metrics you can request. - [Dimensions](https://www.getmcpads.com/docs/sources/google-ads/dimensions): 84 ways to break a report down. - [Skills](https://www.getmcpads.com/skills): 55 operating procedures use this source. ## For your agent | | | | --- | --- | | Platform id | `google_ads` | | Tool prefix | `google_ads_` | | Account parameter | `customerId` | | Dedicated endpoint | https://mcp.getmcpads.com/google-ads/mcp | | Tools | 38, 7 of which write | | Announced by default | `google_ads_get_campaigns`, `google_ads_get_insights`, `google_ads_get_search_terms`, `google_ads_health_check`, `google_ads_list_accounts` | | Metrics | 130, see /docs/sources/google-ads/metrics | | Dimensions | 84, see /docs/sources/google-ads/dimensions | ## Scope requested from the platform | Scope | Grants | Allows writes | | --- | --- | --- | | `https://www.googleapis.com/auth/adwords` | Read and write on Google Ads. Google publishes no read-only alternative, so read-only enforcement is done by this gateway, not by Google. | Yes | ## Reaching a tool that is not announced ```text search_tools({ task: "..." }) find it describe_tool({ name: "..." }) read its schema run_tool({ name, args }) execute, with the same checks ``` ## What will refuse you - An account not ticked by the owner. Call `list_accounts` and use a `customerId` from it. - A write on a plan without writes. The tool is absent from the list and refused if called anyway. - A write without `confirm: true` returns a preview and applies nothing. That is not an error. - A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it. ## Questions this source answers | Question | Tools, in order | | --- | --- | | Which campaigns spend the most and return the least? | `google_ads_get_insights` then `google_ads_get_campaigns` | | Show me search terms we paid for that we would never have bid on. | `google_ads_get_search_terms` | | Is any Performance Max campaign spending without the ad strength to justify it? | `google_ads_get_pmax_asset_diagnostics` then `google_ads_get_pmax_placements` | | Who changed what in the last two weeks? | `google_ads_get_change_events` | | Which Shopping products take spend and return nothing? | `google_ads_get_shopping_performance` then `google_ads_get_shopping_products` | | What would these keywords cost, and how much volume is there? | `google_ads_generate_keyword_ideas` then `google_ads_generate_keyword_forecast_metrics` | | Run this exact GAQL query. | `google_ads_run_gaql` then `google_ads_search_fields` | --- This page as HTML: https://www.getmcpads.com/guides/sources/google-ads Every page under /guides and /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.