Google Ads Mcp

google-ads-mcp

Google Ads 用 MCP サーバー — Claude から費用対効果、インプレッション シェア、アセットのパフォーマンスを診断できます。

キャンペーン、キーワード、RSA、アセット、オーディエンス、地域／デバイス別の内訳、インプレッション シェア、オークション分析、予算消化状況を対象とする22個のツールに加え、GAQLを直接実行するための手段も備えています。実際の診断を行うB2B検索広告チームや代理店向けに構築されており、ダッシュボードのような「キャンペーンを一覧表示して」というクエリだけを目的としたものではありません。

---

このプロジェクトの目的

ほとんどのGoogle Ads MCP サーバーは「キャンペーンの一覧表示と基本指標」で終わります。このサーバーは、検索広告チームが実際に尋ねる質問に対応します。置き換えられるよう、パフォーマンスラベルがLOWのRSAアセットはどれか、コンバージョンがゼロなのに予算を消費しているキーワードはどれか、オークション分析でインプレッション シェアを奪っている相手は誰か、モバイルとデスクトップのCPAにはどれくらい差があるか、現在、予算が制限されているキャンペーンはどれか。これらはパフォーマンスを改善するための重要な手段であり、すべてこのサーバーで主要なツールとして利用できます。

公式のgoogleads/google-ads-mcpとの差別化として、RSAアセットのパフォーマンスラベル、オークション分析、インプレッション シェア分析、地域／デバイス別の内訳、オーディエンス ターゲティングの確認、予算消化状況を提供します。

---

プロンプトの例

インストール後、Claudeに次のように尋ねることができます。

• 「今月の競合とのインプレッション シェアはどれくらいですか？最も頻繁にシェアを奪われている相手は誰ですか？」
• 「パフォーマンスラベルがLOWのRSAアセットをすべて表示してください。置き換えたいです。」
• 「過去30日間で、コンバージョンがゼロなのに最も多く費用を消費しているキーワードはどれですか？」
• 「すべてのキャンペーンで、モバイルとデスクトップのCPAにはどれくらい差がありますか？」
• 「現在、予算が制限されているキャンペーンはありますか？Lost IS (Budget)を表示してください。」
• 「リマーケティング オーディエンスを一覧表示し、検索広告のターゲティングに十分な規模のものを教えてください。」

---

デモ

🎥 操作動画は近日公開予定です — Claudeから60秒以内に無駄な広告費を診断します。

---

機能

カテゴリ	ツール
アカウント	アカウント一覧、アカウント情報
キャンペーン	キャンペーン一覧、キャンペーンのパフォーマンス、広告グループのパフォーマンス
キーワード	キーワードのパフォーマンス、検索語句レポート
コンバージョン	キャンペーン別コンバージョン、コンバージョン アクション一覧
広告文／RSA	広告の強さを含むRSA一覧、RSAアセットのパフォーマンスラベル
アセット／拡張機能	アカウント アセット一覧、キャンペーン アセット
オーディエンス	ユーザーリスト一覧、キャンペーンのオーディエンス ターゲティング
パフォーマンス	地域別パフォーマンス、デバイス別パフォーマンス、インプレッション シェア、オークション分析
予算	予算一覧、予算消化状況
直接実行	GAQLクエリの直接実行

---

前提条件

• Node.js 20+
• Google Adsデベロッパー トークン（こちらから申請）
• Google Cloud Consoleで取得したOAuth 2.0認証情報（クライアントID＋シークレット）
• https://www.googleapis.com/auth/adwordsスコープを持つ更新トークン

---

環境変数

変数	必須	説明
GOOGLE_ADS_DEVELOPER_TOKEN	はい	Google Adsデベロッパー トークン
GOOGLE_ADS_CLIENT_ID	はい	OAuth 2.0クライアントID
GOOGLE_ADS_CLIENT_SECRET	はい	OAuth 2.0クライアントシークレット
GOOGLE_ADS_REFRESH_TOKEN	はい	OAuth 2.0更新トークン
GOOGLE_ADS_CUSTOMER_ID	はい*	デフォルトの顧客ID（ハイフンなし）。ツールの呼び出しごとに上書きできます。
GOOGLE_ADS_LOGIN_CUSTOMER_ID	いいえ	MCCアクセス用のマネージャー アカウントID

---

使い方

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "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"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/path/to/google-ads-mcp/dist/index.js"],
      "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"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["-y", "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"
      }
    }
  }
}

Docker

docker build -t google-ads-mcp .
docker run --rm \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_TOKEN \
  -e GOOGLE_ADS_CLIENT_ID=YOUR_CLIENT_ID \
  -e GOOGLE_ADS_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -e GOOGLE_ADS_REFRESH_TOKEN=YOUR_REFRESH_TOKEN \
  -e GOOGLE_ADS_CUSTOMER_ID=1234567890 \
  google-ads-mcp

---

ツールのリファレンス

ツール	説明
gads_run_gaql	任意の GAQL クエリをそのまま実行します。カスタムレポート用のエスケープハッチです
gads_list_accounts	アクセス可能なすべての Google Ads アカウントを一覧表示します
gads_account_info	名前、通貨、タイムゾーン、マネージャーフラグ、ステータス
gads_list_campaigns	ステータス、チャネルタイプ、入札戦略を含むキャンペーン
gads_campaign_performance	インプレッション数、クリック数、CTR、CPC、費用、コンバージョン数、CPA、ROAS
gads_ad_group_performance	キャンペーンのコンテキストを含む広告グループの指標
gads_keyword_performance	マッチタイプ、品質スコア、費用、コンバージョン数を含むキーワード
gads_search_terms_report	広告の表示につながった実際のユーザークエリ。除外キーワードや機会を見つけます
gads_conversions_by_campaign	キャンペーンごとのコンバージョン数 × コンバージョンアクション
gads_list_conversion_actions	カテゴリ、タイプ、カウント方法を含むすべてのコンバージョンアクション
gads_list_rsas	すべての見出し、説明文、広告の有効性、承認ステータスを含む RSA
gads_rsa_asset_performance	アセットごとのパフォーマンスラベル：BEST / GOOD / LOW / PENDING / LEARNING
gads_list_assets	アカウントのアセット：サイトリンク、コールアウト、構造化スニペット、画像
gads_campaign_assets	フィールドタイプを含む、キャンペーンに関連付けられたアセット
gads_list_audiences	サイズとマッチ率を含むユーザーリスト（リマーケティング、顧客マッチ）
gads_campaign_audience_targeting	入札単価調整と包含／除外設定を含む、キャンペーンのオーディエンス
gads_geo_performance	国、地域、都市別のパフォーマンス
gads_device_performance	MOBILE / DESKTOP / TABLET 別の費用、コンバージョン数、CPA
gads_impression_share	キャンペーンごとの検索インプレッションシェア、予算損失インプレッションシェア、ランク損失インプレッションシェア
gads_auction_insights	競合他社とのインプレッションシェア、重複率、上位掲載率
gads_list_budgets	金額、配信方法、期間、推奨予算を含むすべての予算
gads_budget_pacing	キャンペーンごとの費用と予算、および消化率（%）

---

ソースからビルドする

git clone https://github.com/ZLeventer/google-ads-mcp.git
cd google-ads-mcp
npm install
npm run build

---

ライセンス

MIT — Copyright (c) 2026 Zach Leventer