google-ads-mcp-server

# Google Ads MCP Server by Insightful Pipe

[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://insightfulpipe.com/mcp-servers/google-ads)
[![Insightful Pipe](https://img.shields.io/badge/Insightful_Pipe-MCP_Servers-purple)](https://insightfulpipe.com/mcp-servers)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Listed on MCP Market](https://mcpmarket.com/badge/server/google-ads-20.svg)](https://mcpmarket.com/server/google-ads-20?utm_source=readme&utm_medium=badge)

> **Connect Google Ads to AI assistants for advertising analytics and campaign management.**

Part of the [Insightful Pipe MCP Server Collection](https://insightfulpipe.com/mcp-servers) — Connect your Google Ads account to Claude, ChatGPT, Cursor, and other AI assistants using the Model Context Protocol (MCP). Analyze campaigns, optimize ad spend, and get AI-driven insights directly in your conversations.

[![Explore All MCP Servers](https://img.shields.io/badge/Explore_All-MCP_Servers-blue?style=for-the-badge)](https://insightfulpipe.com/mcp-servers)

![Google Ads MCP Server](https://insightfulpipe.com/images/google_ads-icon.svg)

## MCP Server URL

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

## What is Google Ads MCP?

Google Ads MCP is a **remote Model Context Protocol server** that enables AI assistants to interact with your Google Ads data. This MCP integration allows you to:

- Query campaign performance metrics using natural language
- Analyze ad group and keyword performance
- Get AI-powered recommendations for campaign optimization
- Monitor ROAS, CTR, CPC, and conversion metrics
- Create and manage campaigns, ad groups, and keywords
- Execute custom GAQL queries for advanced reporting

## Installation

### Claude

1. Copy the MCP Server URL: `https://google-ads.insightfulmcp.com/`
2. Open [Claude Connectors Settings](https://claude.ai/settings/connectors)
3. Scroll to the bottom and click **Add custom connector**
4. Paste the URL and click **Add**
5. Click **Connect** and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.

### ChatGPT

Custom MCP servers are added through ChatGPT's **Developer mode**. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.

1. Turn on **Developer mode** in ChatGPT settings
2. Create a new app for a remote MCP server and paste the URL: `https://google-ads.insightfulmcp.com/`
3. Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.

See OpenAI's guide: [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

### Claude Code

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

### Cursor

Add the server to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "google-ads": {
      "url": "https://google-ads.insightfulmcp.com/"
    }
  }
}
```

When Cursor shows **Needs authentication**, click **Connect** and sign in to InsightfulPipe if asked.

### Gemini CLI

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

## Available Actions

99 actions: 37 read, 62 write.

### Read Actions (37)

<details>
<summary>Show all 37 read actions</summary>

| Action | Description |
|--------|-------------|
| `account_performance_report` | Account performance for a date range: clicks, cost, impressions, conversions and all conversions |
| `ad_performance_report` | Ad performance for a date range: status, clicks, cost, impressions and conversions per ad |
| `bidding_strategy_report` | Portfolio bidding strategy performance for a date range: type, status, clicks, cost, cost per conversion, impressions, average CPC and conversions |
| `campaign_performance_report` | Campaign performance for a date range: status, bidding strategy type, clicks, cost, impressions, conversions and all conversions |
| `dsa_search_terms_report` | Dynamic Search Ads search terms: headline and landing page served, clicks, cost, impressions and conversions |
| `gaql` | Execute a GAQL (Google Ads Query Language) query |
| `generate_keyword_ideas` | Generate keyword ideas from seed keywords or URL using Keyword Planner |
| `get_account_info` | Customer account information and settings |
| `get_ad_group_bidding` | Ad group bidding strategy information |
| `get_ad_group_labels` | Ad group label associations |
| `get_ad_groups` | Ad group performance data and configuration |
| `get_ad_labels` | Ad group ad label associations |
| `get_ads` | Ad creative performance data and policy information |
| `get_audiences` | Audience targeting and demographic performance data |
| `get_campaign_bidding` | Campaign bidding strategy configurations |
| `get_campaign_budgets` | Campaign budget configuration and recommendations |
| `get_campaign_labels` | Campaign label associations |
| `get_campaigns` | Campaign performance data and configuration |
| `get_change_history` | Change status history for Google Ads entities |
| `get_clicks` | Click-level performance and location data |
| `get_client_accounts` | Customer client hierarchy and management information |
| `get_criterion_labels` | Ad group criterion label associations |
| `get_customer_labels` | Customer label associations |
| `get_display_keywords` | Display keyword targeting performance |
| `get_geo_performance` | Geographic and location-based performance data |
| `get_keywords` | Keyword performance data and statistics |
| `get_labels` | Label management and organization data |
| `get_non_manager_accounts` | Customer client non-manager accounts only |
| `get_shopping_performance` | Shopping campaign product-level performance data |
| `get_topics` | Topic targeting performance data |
| `get_user_interests` | User interest categories and availability |
| `get_user_locations` | User location-based performance data |
| `keyword_performance_report` | Keyword performance for a date range: status, first-page, first-position and top-of-page CPC estimates |
| `list_bidding_strategies` | List portfolio bidding strategies with type, status, targets, bid limits and attached campaign counts |
| `list_conversion_actions` | List conversion actions (id, name, type, category, status); pass conversion_action_id for one with its tag snippets |
| `search_terms_report` | Search terms that triggered ads: match type, clicks, cost, impressions and conversions |
| `suggest_geo_targets` | Search for geo target constants by name (city, postal code, region) to get IDs for location targeting |

</details>

### Write Actions (62)

<details>
<summary>Show all 62 write actions</summary>

| Action | Description |
|--------|-------------|
| `add_audience_targeting` | Target a user list (remarketing audience) with an ad group |
| `add_call_asset` | Add a phone call asset to the account (shows phone number with ads) |
| `add_callout_asset` | Add callout text snippets to the account or to a campaign (e.g., 'Free Shipping', '24/7 Support') |
| `add_demographic_targeting` | Add age and/or gender demographic targeting to an ad group |
| `add_dsa_webpage_targeting` | Add a webpage-targeting criterion to a DSA ad group (incl. page-feed label targeting) |
| `add_keywords` | Add keywords to an ad group |
| `add_label` | Create a new label for organizing campaigns, ad groups, and ads |
| `add_lead_form_asset` | Add a lead form to a campaign (users submit info directly from the ad) |
| `add_location_targeting` | Add geographic location targeting to a campaign (countries, cities, postal codes, regions) |
| `add_negative_keywords` | Add negative keywords at campaign or ad group level |
| `add_price_asset` | Add a price asset to the account (shows product/service pricing under ads) |
| `add_proximity_targeting` | Add radius/proximity targeting to a campaign (target users within a radius around coordinates) |
| `add_sitelinks` | Add sitelink assets to a campaign (clickable links below the ad) |
| `add_structured_snippet_asset` | Add a structured snippet to a campaign (category-based highlights) |
| `apply_label` | Apply a label to campaigns, ad groups, or ads |
| `attach_conversion_actions_to_campaign` | Bind specific conversion actions to an App campaign via Campaign.selective_optimization |
| `create_ad_group` | Create a new ad group (always created as PAUSED) |
| `create_app_ad` | Create an App ad in an existing App campaign ad group |
| `create_app_campaign` | Create an App campaign with its initial App ad group (always created as PAUSED) |
| `create_app_deep_link_asset` | Create an app deep link asset for App ads |
| `create_asset_group` | Add an asset group to an existing Performance Max campaign |
| `create_bidding_strategy` | Create a portfolio bidding strategy (Target CPA, Target ROAS, Maximize Conversions or Maximize Conversion Value) that campaigns share |
| `create_campaign` | Create a new campaign (always created as PAUSED) |
| `create_conversion_action` | Create a conversion action to track valuable user actions |
| `create_display_campaign` | Create a Display campaign with ad group and responsive display ad in one atomic request |
| `create_dsa_campaign` | Create a Dynamic Search Ads (DSA) Search campaign (always created as PAUSED) |
| `create_dynamic_search_ad` | Create a Dynamic Search Ad in a DSA ad group (always created as PAUSED) |
| `create_page_feed` | Create a DSA page feed (AssetSet of type PAGE_FEED) with page URLs and labels |
| `create_performance_max_campaign` | Create a Performance Max campaign with asset group in one atomic request |
| `create_responsive_display_ad` | Create a responsive display ad (always created as PAUSED) |
| `create_responsive_search_ad` | Create a responsive search ad (always created as PAUSED) |
| `create_search_campaign` | Create a new Search campaign (always created as PAUSED) |
| `create_user_list` | Create a new user list (remarketing audience) for Customer