Google Ads MCP

Name: Google Ads MCP
Author: scalably-io

作者：scalably-ioバージョン 1.0.1i★ –iパソコンで動く

レジストリ名io.scalably/google-ads-mcp

インストール

概要

作者による説明（英語の原文）

Google Ads MCP: GAQL queries, resources, recommendations, keyword ideas, change history. 11 tools.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: マーケティング・SNS
入力が必要なもの：GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID, GOOGLE_ADS_API_VERSION, GOOGLE_ADS_LOG_LEVEL, GOOGLE_ADS_USE_PROTO_PLUS

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

PyPIPythonのuvのインストール（uvxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

作者の .mcpb ファイルをダウンロード

リンク先は作者自身のファイルです。私たちが置いたり再パッケージしたりしたものではありません。ファイルを開くと、Claude Desktopがインストールします。

ターミナルでこれを実行します

claude mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=your-value --env GOOGLE_ADS_CLIENT_ID=your-value --env GOOGLE_ADS_CLIENT_SECRET=your-value --env GOOGLE_ADS_REFRESH_TOKEN=your-value --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=your-value --env GOOGLE_ADS_API_VERSION=your-value --env GOOGLE_ADS_LOG_LEVEL=your-value --env GOOGLE_ADS_USE_PROTO_PLUS=your-value -- uvx scalably-google-ads-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "scalably-google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
        "GOOGLE_ADS_CLIENT_ID": "your-value",
        "GOOGLE_ADS_CLIENT_SECRET": "your-value",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-value",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your-value",
        "GOOGLE_ADS_API_VERSION": "your-value",
        "GOOGLE_ADS_LOG_LEVEL": "your-value",
        "GOOGLE_ADS_USE_PROTO_PLUS": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "google-ads": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "scalably-google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-value",
        "GOOGLE_ADS_CLIENT_ID": "your-value",
        "GOOGLE_ADS_CLIENT_SECRET": "your-value",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-value",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your-value",
        "GOOGLE_ADS_API_VERSION": "your-value",
        "GOOGLE_ADS_LOG_LEVEL": "your-value",
        "GOOGLE_ADS_USE_PROTO_PLUS": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

GOOGLE_ADS_DEVELOPER_TOKEN 秘密必須 env
Google Ads API developer token from the Ads API Center
GOOGLE_ADS_CLIENT_ID 必須 env
OAuth2 client_id for a Desktop-app credential
GOOGLE_ADS_CLIENT_SECRET 秘密必須 env
OAuth2 client_secret paired with the client_id
GOOGLE_ADS_REFRESH_TOKEN 秘密必須 env
Long-lived OAuth2 refresh_token for the adwords scope
GOOGLE_ADS_LOGIN_CUSTOMER_ID 必須 env
10-digit customer ID of the manager account (MCC)
GOOGLE_ADS_API_VERSION env
Google Ads API version to target, default set by the server
GOOGLE_ADS_LOG_LEVEL env
Log level, default WARNING
GOOGLE_ADS_USE_PROTO_PLUS env
Use proto-plus message types, default true

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名はドメイン scalably.io で確認済みです（レジストリがドメインの所有を確認しています）
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

マーケティング・SNSのほかのサーバーとの比較i

このカテゴリのほかの2987件のうち0%よりスターが多い
このカテゴリのほかの2987件のうち32%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2987件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Google Ads MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（1.0.1）がレジストリに届いたのは2 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv), MCPBも必要です。

代わりに使えるものは？

同じカテゴリには：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

MCP YouTube Transcript

作者：jkawamoto

An MCP server retrieving transcripts of YouTube videos

パソコンで動く★ 495MIT10 日前更新

インストール

Google Analytics MCP

作者：surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

パソコンで動く★ 244MIT10 日前更新

インストール

BibiGPT YouTube Video Summarizer

作者：JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

クラウドで動く★ 137MIT10 日前更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Google Ads MCP

Read-only MCP server for the Google Ads API. Eleven tools cover discovery, GAQL reporting, resource schema, recommendations, keyword planning and forecasts, and change history for any account reachable under a manager account (MCC). We run this server in production for every ads client. Read-only is enforced at three layers: no mutate or apply service imports, an SDK method allowlist, and a GAQL-starts-with-SELECT guard.

Install

Claude Code:

claude mcp add google-ads \

-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_LOGIN_CUSTOMER_ID=1234567890 \ -- uvx scalably-google-ads-mcp

Codex:

codex mcp add google-ads \

--env GOOGLE_ADS_DEVELOPER_TOKEN=your-token \ --env GOOGLE_ADS_CLIENT_ID=your-client-id \ --env GOOGLE_ADS_CLIENT_SECRET=your-client-secret \ --env GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token \ --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=1234567890 \ -- uvx scalably-google-ads-mcp

Claude Desktop: download google-ads-mcp.mcpb from the latest GitHub release and open it.

Setup

This is the heaviest setup in the gallery: expect up to two days waiting on developer token approval. One set of credentials, rooted at a manager account (MCC), can read any customer account linked under it, so there is no per-client configuration beyond linking an account to the MCC.

Google Ads developer token. Sign in at ads.google.com under your manager account, go to Tools and Settings, API Center, and apply for a developer token. A new token starts on the Explorer access level, which Google grants after a review that can take a few days; discovery, query and recommendation tools work there. Basic access (a separate application) is needed for higher quotas and may be needed for the keyword-planning tools.
Google Cloud OAuth client. In a Google Cloud project, enable the Google Ads API, then create an OAuth client ID of type Desktop app under APIs and Services, Credentials. Note the client ID and client secret, and add the https://www.googleapis.com/auth/adwords scope to the OAuth consent screen.
Refresh token. Generate a refresh token once, as an admin user of the manager account, using Google's oauth2l tool or the generate_user_credentials.py example shipped with the google-ads Python library. Save the refresh token; it does not expire from normal use.
Login customer ID. Use the 10-digit customer ID of the manager account itself (no hyphens) as GOOGLE_ADS_LOGIN_CUSTOMER_ID. Any client account accepts an invite to link under this manager account in its own Google Ads UI, after which google_ads_list_customer_clients sees it.

Tools (11)

Tool	What it does
`google_ads_list_accessible_customers`	List every customer_id the OAuth user has direct access to
`google_ads_list_customer_clients`	Walk the MCC hierarchy and return every child account
`google_ads_query`	Run a GAQL query against a specific customer account
`google_ads_describe_resource`	Schema (fields, metrics, segments) for a GAQL resource
`google_ads_list_resources`	Return the full catalog of GAQL resources
`google_ads_recommendations`	Read Google's optimization recommendations for a customer account
`google_ads_keyword_ideas`	Generate keyword ideas with search volume, competition and CPC estimates
`google_ads_keyword_historical_metrics`	Historical monthly search-volume and competition metrics for specific keywords
`google_ads_keyword_forecast_metrics`	Forecast KPIs for a proposed keyword plan
`google_ads_change_events`	Audit trail of who changed what, last 30 days
`google_ads_change_status`	Lightweight last-modified change tracker per resource

Configuration

Variable	Required	Purpose
`GOOGLE_ADS_DEVELOPER_TOKEN`	yes	Google Ads API developer token from the Ads API Center
`GOOGLE_ADS_CLIENT_ID`	yes	OAuth2 client_id for a Desktop-app credential
`GOOGLE_ADS_CLIENT_SECRET`	yes	OAuth2 client_secret paired with the client_id
`GOOGLE_ADS_REFRESH_TOKEN`	yes	Long-lived OAuth2 refresh_token for the adwords scope
`GOOGLE_ADS_LOGIN_CUSTOMER_ID`	yes	10-digit customer ID of the manager account (MCC), no hyphens
`GOOGLE_ADS_API_VERSION`	no	Google Ads API version to target, default v25
`GOOGLE_ADS_USE_PROTO_PLUS`	no	Use proto-plus message types, default true
`GOOGLE_ADS_LOG_LEVEL`	no	Python log level, default WARNING

Reply shape

Every tool returns JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures surface as a tool error whose text is google_ads_request_failed: . proof.apiVersion names the Google Ads API version used. proof.microsConverted is set on google_ads_query. A partial status means the result hit its configured bound (max_rows, page_size or limit); recovery.nextAction says how to continue.

Limits

google_ads_query responses are capped at 64 MB per call by the Google Ads API; split large date ranges across calls. KeywordPlanIdeaService (keyword ideas, historical metrics, forecasts) is rate-limited to 1 query per second and may require Basic Access if you get a permission error on the Explorer tier. google_ads_change_events covers up to 30 days back; google_ads_change_status covers up to 14 days back. metrics.cost_micros and other *_micros fields are 1 unit = $0.000001; google_ads_query emits a matching *_units field alongside when convert_micros is true (the default).

Verify

Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the built wheel on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html

Google Ads MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

マーケティング・SNSのほかのサーバーとの比較i

よくある質問

代わりの候補

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

作者のREADME

Google Ads MCP

Install

Setup

Tools (11)

Configuration

Reply shape

Limits

Verify

Privacy Policy

License