Google Ads MCP Server

Complete MCP server for Google Ads management with full CRUD, visualization dashboard, reports, and management of all features available in the Google Ads panel.

Features (85+ tools)

Accounts & Customers

• list_accessible_customers — List accessible accounts

• get_customer_details — Account details

• list_customer_clients — Clients under MCC

• update_customer — Update settings

• get_account_hierarchy — Account hierarchy

• get_change_history — Change history

Campaigns (Full CRUD)

• list_campaigns — List campaigns with filters

• get_campaign — Full campaign details

• create_campaign — Create campaign (Search, Display, Shopping, Video, Performance Max, etc.)

• update_campaign — Update name, status, bids, dates

• remove_campaign — Remove campaign

• get_campaign_performance — Performance metrics

• copy_campaign — Copy campaign settings

Ad Groups (Full CRUD)

• list_ad_groups — List ad groups

• get_ad_group — Group details

• create_ad_group — Create ad group

• update_ad_group — Update settings

• remove_ad_group — Remove group

• get_ad_group_performance — Performance metrics

Ads (Full CRUD)

• list_ads — List ads

• get_ad — Ad details

• create_responsive_search_ad — Create RSA with headlines and descriptions

• update_ad_status — Enable/pause ad

• remove_ad — Remove ad

• get_ad_performance — Performance metrics

Keywords (Full CRUD)

• list_keywords — List keywords with quality score

• add_keywords — Add keywords (Exact, Phrase, Broad)

• update_keyword — Update bid, status, URLs

• remove_keyword — Remove keyword

• get_keyword_performance — Performance with impression share

• get_search_terms — Search terms report

• add_negative_keywords — Add negatives (campaign or ad group)

Budgets & Bidding Strategies

• list_budgets — List budgets

• create_budget — Create budget

• update_budget — Update amount/delivery method

• remove_budget — Remove budget

• list_bidding_strategies — List strategies

• create_bidding_strategy — Create strategy (Target CPA, Target ROAS, etc.)

• update_bidding_strategy — Update strategy

• remove_bidding_strategy — Remove strategy

Audiences & Targeting

• list_audiences — List audiences/user lists

• get_audience_performance — Audience performance

• list_campaign_targeting — Targeting criteria

• add_campaign_location_targeting — Geographic targeting

• add_campaign_language_targeting — Language targeting

• add_ad_schedule — Ad scheduling (dayparting)

• remove_campaign_criterion — Remove criterion

• get_geo_target_constants — Search geographic constants

• get_demographics_performance — Demographic performance

Assets & Extensions

• list_assets — List all assets

• create_sitelink_asset — Create sitelink

• create_callout_asset — Create callout

• create_structured_snippet_asset — Create structured snippets

• create_call_asset — Create call extension

• create_price_asset — Create price extension

• create_promotion_asset — Create promotion extension

• create_lead_form_asset — Create lead form

• link_asset_to_campaign — Link asset to campaign

• link_asset_to_ad_group — Link asset to ad group

• remove_asset — Remove asset

• get_asset_performance — Asset performance

• list_campaign_assets — Campaign assets

• remove_campaign_asset — Unlink asset

Conversions

• list_conversion_actions — List conversion actions

• get_conversion_action — Conversion details

• create_conversion_action — Create conversion action

• update_conversion_action — Update conversion

• remove_conversion_action — Remove conversion

• get_conversion_performance — Conversion performance

Reports & Dashboard

• execute_gaql_query — Execute custom GAQL query

• get_account_dashboard — Full account dashboard

• get_campaign_dashboard — Detailed campaign dashboard

• get_performance_by_device — Performance by device

• get_performance_by_network — Performance by network

• get_performance_by_hour — Performance by hour

• get_performance_by_day_of_week — Performance by day of week

• get_geographic_performance — Geographic performance

• get_landing_page_performance — Landing page performance

• compare_date_ranges — Compare date ranges

Labels & Shared Sets

• list_labels — List labels

• create_label — Create label

• remove_label — Remove label

• apply_label_to_campaign — Apply label to campaign

• apply_label_to_ad_group — Apply label to ad group

• list_shared_sets — List shared sets

• create_shared_set — Create shared negative list

• add_shared_set_criteria — Add terms to list

• link_shared_set_to_campaign — Link list to campaign

Recommendations & Optimization

• list_recommendations — List Google recommendations

• apply_recommendation — Apply recommendation

• dismiss_recommendation — Dismiss recommendation

• get_optimization_score — Optimization score

Experiments & Changes

• list_experiments — List A/B tests

• list_experiment_arms — List variants

• get_change_status — Recent changes

Prerequisites

1. Google Cloud Project with the Google Ads API enabled

2. OAuth2 Client ID of type Desktop

3. Developer Token from Google Ads (obtained at ads.google.com > API Center)

4. Node.js >= 18

Installation

npm install
npm run build

Configuration

Option 1: Environment variables

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

Option 2: Interactive setup

npm run auth

This will create a credentials file at ~/.google-ads-mcp/credentials.json.

Claude Code Configuration

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Usage

After configuration, all tools are available via MCP. Examples:

• "List all my active campaigns"

• "Create a Search campaign with a R$50/day budget"

• "Show the performance dashboard for the last 30 days"

• "Add these keywords to ad group X: ..."

• "Pause campaign Y"

• "Show the search terms report"

• "What are Google's recommendations for my account?"

API Version

This server uses the Google Ads API v23 (latest, released in January 2026).

Project Structure

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions