mcp-gads

Google Ads MCP サーバー — 自然言語でキャンペーン、キーワード、アセットなどを照会できます。
Bun + TypeScript で構築されています。Claude、Cursor、およびあらゆる MCP クライアントで動作します。

クイックスタート

1. 認証情報を取得する

Google Ads API の開発者トークンと OAuth クライアント認証情報が必要です。

1. Google Cloud Console から OAuth クライアントの JSON をダウンロードします
2. 環境変数を設定します：

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

3. セットアップヘルパーを実行して認証します：

npx mcp-gads setup

ブラウザーが開き、OAuth が完了すると、更新トークンが保存されます。

2. Claude Code に追加する

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 を再起動すると、ツールを利用できます。セッションごとに最新バージョンが自動的に実行されます。

Bun がインストールされている場合は、bunx mcp-gads@latest でも動作します。 npx 経由で実行する場合は Node 22 以降が必要です。

実行時にお使いの環境から 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

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

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

Codex では JSON ではなく TOML を使用します。一度インストールしてから、~/.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 でエラーが表示されないまま失敗する原因となる注意点が 3 つあります：

• タイムアウトを延長せずに npx -y を使用しないでください。 Codex のデフォルトの startup_timeout_sec は 10 秒で、npx の初回ダウンロードには短すぎます。グローバルインストール（上記）またはビルド済みバイナリを使えば、この問題を回避できます。npx を使う必要がある場合は、startup_timeout_sec = 30 を追加してください。
• 環境変数は [mcp_servers.gads.env] の下に設定してください。 Codex は親シェルの環境を stdio サーバーに引き継ぎません。シェルで変数をエクスポートしても、サーバーには届きません。
• GOOGLE_ADS_CREDENTIALS_PATH には絶対パスを使用してください。 Codex は独自の作業ディレクトリでサーバーを起動するため、相対パスではファイルが見つからず、エラーも表示されません。

Windows では、Codex の一部のバージョンで _sec の代わりに startup_timeout_ms = 20000 を使用します。

Claude Desktop

claude_desktop_config.json に追加します：

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

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

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

更新するには、新しいバイナリをダウンロードし、古いものと置き換えてください。

開発

Bun が必要です。

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

ライセンス

MIT