广告合作
MCP.so
登录

Google Ads MCP Server

@cohnen

代码仓库主页

基本信息

分类

数据与分析

许可证

MIT

传输方式

stdio

作者

cohnen

关于 Google Ads MCP Server

An MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th

#ai#mcp#claude#google-ads#mcp-server

Google Ads MCP Server 配置

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

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/Users/cohnen/dev/mcp-google-ads/.venv/bin/python",
      "args": [
        "/Users/cohnen/dev/mcp-google-ads/google_ads_server.py"
      ],
      "env": {
        "GOOGLE_ADS_CREDENTIALS_PATH": "/Users/cohnen/dev/mcp-google-ads/google_ads_token.json",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "",
        "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
        "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>"
      }
    }
  }
}

Google Ads MCP Server 工具

5

Shows all your Google Ads accounts

Runs a Google Ads Query Language query

Shows campaign metrics with performance data

Detailed analysis of your ad creative performance

Runs any arbitrary GAQL query with formatting options

概览

What is Google Ads MCP?

A tool that connects Google Ads data with Claude AI, enabling analysis of advertising data through natural language conversations. It provides access to campaign information, performance metrics, keyword analytics, and ad management for advertising professionals.

How to use Google Ads MCP?

Set up Google Ads API access (OAuth 2.0 or Service Account), obtain a developer token, install Python 3.11+, Node.js, and Claude Desktop. Download the repository, create a virtual environment, install dependencies, and configure a .env file with your credentials. Then ask Claude to use tools like list_accounts, execute_gaql_query, get_campaign_performance, get_ad_performance, or run_gaql.

Key features of Google Ads MCP

  • View all Google Ads accounts and campaign information.
  • Track impressions, clicks, conversions, and cost metrics.
  • Identify top and underperforming keywords.
  • Analyze ad copy effectiveness and quality scores.
  • Monitor campaign budgets and bid strategies.
  • Run custom GAQL queries with flexible formatting options.

Use cases of Google Ads MCP

  • An advertising manager asks Claude to show which campaigns are performing best this month.
  • A marketer analyzes keyword quality scores to optimize ad copy.
  • A budget owner monitors spending and gets recommendations for reallocation.
  • An analyst runs a custom GAQL query to compare conversion trends across periods.

常见问题

1

What authentication methods does Google Ads MCP support?

OAuth 2.0 Client ID for user-level access (desktop apps) and Service Account for server-to-server, automated workflows.

2

Is the Login Customer ID required?

It is optional. Use it when working with a Google Ads Manager Account (MCC) to access multiple client accounts. Skip if accessing a single account directly.

3

How do I get a Google Ads API Developer Token?

Sign in to your Google Ads account, go to Tools & Settings > Setup > API Center, accept terms, apply for a token, and wait for approval (usually 1–3 business days).

4

What are the runtime requirements?

Python 3.11 or newer, Node.js, and the Claude Desktop application. The mcp package and other dependencies listed in requirements.txt must be installed.

5

Can I run custom queries?

Yes, the `run_gaql` tool lets you execute any arbitrary Google Ads Query Language (GAQL) query with formatting options (table, JSON, or CSV).

评论

数据与分析 分类下的更多 MCP 服务器

Tracetify — Competitor Ads, Growth Traces & Search Console

tracetify

17 tools for marketing and SEO research inside Claude Code, Cursor, Codex or ChatGPT: the ads any domain runs on Meta and Google, how a product grew from 12 public sources with every claim linked, your own Search Console

1

Lawstronaut Legal Research

Lawstronaut-FZCO

Connect your AI to millions of laws and court cases! Lawstronaut is the infrastructure layer that connects AI agents and software to millions of legal documents across 150+ jurisdictions, structured legal data, continuou

1

QQQ AI Visibility Checker

Meelis Vill

Connect the free QQQ AI Visibility Checker to Claude, ChatGPT, Cursor or VS Code: a public MCP server at https://qqq.ee/mcp, no API key, two read-only tools.

YouTube MCP Server

HasData

Hosted YouTube MCP server for search, video metadata, channel data and timestamped transcripts. Connect Claude, Cursor or other MCP clients with HasData; no YouTube API key required.

6

Rivalize

Downshift

Competitive intelligence for AI agents: competitor teardowns, pricing, ads, reviews and momentum, cited and dated. Read-only by default.

广告合作