Google Ads Mcp

Name: Google Ads Mcp
Author: ZLeventer

@ZLeventer

Repository

About Google Ads Mcp

MCP server for Google Ads — diagnose spend efficiency, impression share, and asset performance from Claude.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@zleventer/google-ads-mcp"
      ],
      "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_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Ads MCP?

An MCP server that provides Claude with 22 tools to diagnose Google Ads spend efficiency, impression share, and asset performance. Built for B2B paid search teams and agencies who need real performance fixes, not just dashboard queries.

How to use Google Ads MCP?

Install by running npx -y google-ads-mcp and configure in Claude Desktop, Claude Code, or Cursor with environment variables: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, and GOOGLE_ADS_CUSTOMER_ID. Use the 22 tool names (e.g., gads_rsa_asset_performance) to execute queries.

Key features of Google Ads MCP

22 tools across campaigns, keywords, RSAs, assets, audiences
RSA asset performance labels (BEST/GOOD/LOW)
Auction insights and impression share analysis
Geo and device performance splits
Budget pacing and utilization % per campaign
Raw GAQL escape hatch for custom queries

Use cases of Google Ads MCP

Identify RSA assets with LOW labels to replace
Find keywords burning budget with zero conversions
Analyze impression share loss against competitors
Compare mobile vs desktop CPA across all campaigns
Detect budget-limited campaigns using Lost IS (Budget)

FAQ from Google Ads MCP

What authentication is required?

OAuth 2.0 credentials (Client ID + Secret) with a refresh token scoped to https://www.googleapis.com/auth/adwords, plus a Google Ads Developer Token.

What are the runtime requirements?

Node.js 20+ is required.

How does this differ from the official Google Ads MCP server?

It ships RSA asset performance labels, auction insights, impression share analysis, geo/device splits, audience targeting inspection, and budget pacing — features not in googleads/google-ads-mcp.