mcp-google-ads

Overview

The Google Ads MCP server provides a comprehensive interface for advertising professionals to analyze and manage their Google Ads campaigns through natural language interactions. It exposes multiple tools for account management, campaign analytics, keyword performance tracking, and budget management. The server supports both OAuth 2.0 and service account authentication methods, with automatic token refreshing capabilities.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_accounts

  Shows all your Google Ads accounts

  Try:Show me all my Google Ads accountsTry:List my advertising accounts
• execute_gaql_query

  Runs a Google Ads Query Language query

  Try:Run a GAQL query to get campaign metricsTry:Execute this GAQL query: SELECT campaign.name, metrics.clicks FROM campaign
• get_campaign_performance

  Shows campaign metrics with performance data

  Try:Show me campaign performance for last monthTry:Get campaign performance metrics for Q3 2023
• get_ad_performance

  Detailed analysis of your ad creative performance

  Try:Analyze my ad performance dataTry:Get detailed metrics on my ad creative performance
• run_gaql

  Runs any arbitrary GAQL query with formatting options

  Try:Run this GAQL query: SELECT keyword.text, metrics.ctr FROM keyword_viewTry:Execute a custom GAQL query with table format

Comparable tools

Installation

{
  "mcpServers": {
    "google-ads": {
      "command": "python",
      "args": ["-m", "mcp_google_ads.server"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
        "GOOGLE_ADS_CLIENT_ID": "your-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your-id"
      }
    }
  }
}

FAQ

Which authentication method should I use?

Choose OAuth 2.0 for individual users or desktop apps where users need to grant access. Choose service accounts for automated systems or managing multiple accounts programmatically.

How long does it take to get a Google Ads API developer token?

Usually 1-3 business days after submitting your application. Initially you'll get a test token with limitations, which can later be upgraded to a production token.

Compare mcp-google-ads with