MCP Gads

Google Ads MCP server — query campaigns, keywords, assets & more via natural language.

Built with Bun + TypeScript. Works with Claude, Cursor, and any MCP client.

______________________________________________________________________

快速开始

1.获取凭据

你需要一个 Google Ads API开发者代币 以及OAuth客户端凭据。

1. 从下载OAuth客户端JSON 谷歌云控制台
2. 设置环境变量：

export GOOGLE_ADS_DEVELOPER_TOKEN=your-token
export GOOGLE_ADS_CREDENTIALS_PATH=./credentials.json

1. 运行安装帮助程序以授权：

npx mcp-gads setup

这将打开您的浏览器，完成OAuth，并保存刷新令牌。

2.添加到克劳德代码

claude mcp add google-ads --scope user --transport stdio \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
  -e GOOGLE_ADS_CREDENTIALS_PATH=/path/to/credentials.json \
  -- npx -y mcp-gads@latest

就是这样。重新启动Claude Code，工具就可用了。每个会话都会自动运行最新版本。

也与 bunx mcp-gads@latest 如果你有 包子. 通过运行时需要Node 18+ npx.

如果您的环境在运行时阻止了npm注册表访问，请安装一次并直接运行已发布的二进制名称：

npm i -g mcp-gads@latest
claude mcp add google-ads --scope user --transport stdio \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
  -e GOOGLE_ADS_CREDENTIALS_PATH=/path/to/credentials.json \
  -- mcp-gads

Alternative: standalone binary

从下载预构建的二进制文件 发布:

macOS/Linux：

curl -Lo mcp-gads https://github.com/pijusz/mcp-gads/releases/latest/download/mcp-gads-darwin-arm64
chmod +x mcp-gads
sudo mv mcp-gads /usr/local/bin/
claude mcp add google-ads --scope user --transport stdio \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=your-token \
  -e GOOGLE_ADS_CREDENTIALS_PATH=/path/to/credentials.json \
  -- /usr/local/bin/mcp-gads

Windows（PowerShell）：

Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-gads/releases/latest/download/mcp-gads-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcp-gads.exe"
claude mcp add google-ads --scope user --transport stdio -e GOOGLE_ADS_DEVELOPER_TOKEN=your-token -e GOOGLE_ADS_CREDENTIALS_PATH=C:\path\to\credentials.json -- "%LOCALAPPDATA%\mcp-gads.exe"

ChatGPT法典

Codex使用TOML，而不是JSON。安装一次，然后添加到 ~/.codex/config.toml:

npm i -g mcp-gads

[mcp_servers.gads]
command = "mcp-gads"

[mcp_servers.gads.env]
GOOGLE_ADS_DEVELOPER_TOKEN = "your-token"
GOOGLE_ADS_CREDENTIALS_PATH = "/absolute/path/to/credentials.json"

导致Codex无声失败的三个陷阱：

• 不使用 npx -y 而不提高超时时间。 Codex的默认设置 startup_timeout_sec 是10s，对于npx的首次运行下载来说太短了。全局安装（如上）或 预构建二进制文件 完全回避了这一点。如果必须使用npx，请添加 startup_timeout_sec = 30.
• 环境必须被破坏 [mcp_servers.gads.env]. Codex不会将父shell环境继承到stdio服务器中——在shell中导出变量不会到达服务器。
• 使用绝对路径 为了 GOOGLE_ADS_CREDENTIALS_PATH.code使用自己的cwd生成服务器，因此相对路径会自动丢失。

在Windows上，某些Codex版本使用 startup_timeout_ms = 20000 而不是 _sec.

克劳德桌面版

添加到您的 claude_desktop_config.json:

Using npx (auto-updates)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "mcp-gads@latest"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Using binary (macOS / Linux)

{
  "mcpServers": {
    "google-ads": {
      "command": "/usr/local/bin/mcp-gads",
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
        "GOOGLE_ADS_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

Using binary (Windows)

{
  "mcpServers": {
    "google-ads": {
      "command": "C:\\Users\\YOU\\AppData\\Local\\mcp-gads.exe",
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-token",
        "GOOGLE_ADS_CREDENTIALS_PATH": "C:\\path\\to\\credentials.json"
      }
    }
  }
}

工具（39）

账户管理

查询

活动

广告

资产

关键词

地理和设备

洞察

扩展工具（默认禁用）

启用 GOOGLE_ADS_ENABLE_EXTENDED_TOOLS=true:

写入工具（默认禁用）

启用 GOOGLE_ADS_ENABLE_MUTATIONS=true:

配置

更新

使用 npx @latest （推荐）：您始终获得最新版本，无需手动更新。

使用二进制：服务器在启动时检查新版本，如果过时，则记录到stderr：

[mcp-gads] v0.2.0 available (current: v0.1.0). Download: https://github.com/pijusz/mcp-gads/releases/latest

检查您安装的版本：

mcp-gads --version

要更新，请下载新的二进制文件并替换旧的。

发展

需要 包子.

git clone https://github.com/pijusz/mcp-gads.git
cd mcp-gads
bun install
bun test           # tests
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

许可证

麻省理工学院