← Back to MCP Servers

Google Ads MCP Server

A tool that connects Google Ads with Claude AI, allowing you to analyze your advertising data through natural language conversations.

What Can This Tool Do For Advertising Professionals?

Account Management

  • See all your Google Ads accounts in one place
  • Get account details and basic campaign information

Campaign Analytics & Reporting

  • Discover which campaigns are performing best
  • Track impressions, clicks, conversions, and cost metrics
  • Analyze performance trends over time
  • Compare different time periods to spot changes
  • Visualize your data with charts and graphs created by Claude

Keyword & Ad Performance

  • Identify top and underperforming keywords
  • Analyze ad copy effectiveness
  • Check quality scores and competitive metrics
  • Get actionable insights on how to improve your campaigns

Budget & Bid Management

  • Monitor campaign budgets and spending
  • Analyze bid strategies and performance
  • Identify opportunities for optimization
  • Get recommendations for budget allocation

Available Tools

Tool NameDescriptionWhat You'll Need
list_accountsShows all your Google Ads accountsNothing - just ask!
execute_gaql_queryRuns a Google Ads Query Language queryYour account ID and a GAQL query
get_campaign_performanceShows campaign metrics with performance dataYour account ID and time period
get_ad_performanceDetailed analysis of your ad creative performanceYour account ID and time period
run_gaqlRuns any arbitrary GAQL query with formatting optionsYour account ID, query, and format (table, JSON, or CSV)

Getting Started

1. Set Up Google Ads API Access

Before using this tool, you'll need to create API credentials. You can choose between two authentication methods:

Option A: OAuth 2.0 Client ID

Best for individual users or desktop applications:

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Google Ads API
  4. Go to "Credentials" → "Create Credentials" → "OAuth Client ID"
  5. Choose "Desktop Application" as the application type
  6. Download the OAuth client configuration file

Option B: Service Account

Better for automated systems or managing multiple accounts:

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Google Ads API
  4. Go to "Credentials" → "Create Credentials" → "Service Account"
  5. Download the service account key file (JSON)
  6. Grant the service account access to your Google Ads accounts

2. Get a Developer Token

  1. Sign in to your Google Ads account at ads.google.com
  2. Click on Tools & Settings (wrench icon) in the top navigation
  3. Under "Setup", click "API Center"
  4. Accept the Terms of Service if you haven't already
  5. Click "Apply for token" and fill out the application form
  6. Submit the application and wait for approval (usually 1-3 business days)

3. Connect to Claude or Cursor

Add the server configuration to your Claude Desktop or Cursor MCP settings:

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/.venv/bin/python",
      "args": ["/FULL/PATH/TO/google_ads_server.py"],
      "env": {
        "GOOGLE_ADS_AUTH_TYPE": "oauth",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/path/to/credentials.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID"
      }
    }
  }
}

Example Queries

Here are some powerful prompts you can use:

  • List accounts: "List all my Google Ads accounts and tell me which ones have the highest spend this month."
  • Campaign performance: "Show me the top 10 campaigns for account 123-456-7890 in the last 30 days."
  • Ad analysis: "Do a comprehensive analysis of which ad copy elements are driving the best CTR."
  • GAQL queries: "Run this query: SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7DAYS"

Connection Details

Connection URL:

https://mcp.leonhoulier.com/google-ads/mcp

Resources