Google Ads Mcp

Name: Google Ads Mcp
Author: ZLeventer

@ZLeventer

代码仓库

关于 Google Ads Mcp

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

基本信息

分类

其他

传输方式

stdio

发布者

ZLeventer

提交者

Zach Leventer

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.