Google Analytics 4

Google Analytics 4 MCP サーバー

Google Analytics 4 用の MCP サーバーです。Admin API と Data API を介して、プロパティの作成、データストリームの設定、コンバージョンの管理、レポートの実行ができます。

セットアップ（初回のみ、約 3 分）

1. Google Cloud Console → IAM & Admin → Service Accounts

   • サービスアカウントを作成します（任意の名前）
   • アカウントをクリック → Keys → Add Key → JSON → ダウンロード

2. GCP プロジェクトで API を有効にします：

   • Google Analytics Admin API
   • Google Analytics Data API

3. GA4 Admin → Property Access Management → JSON から取得したサービスアカウントのメールアドレスを Editor として追加します

4. 認証情報を設定します（いずれかを選択）：

   • オプション A（推奨）：JSON の内容を MCP 設定の GA_CREDENTIALS 環境変数にコピーします
   • オプション B：ファイルを ~/.google-analytics-4-mcp/credentials.json に保存します

これで完了です。ブラウザーでの認証フローも、同意画面も、更新が必要なトークンもありません。

インストール

Claude Code

claude mcp add google-analytics -e GA_CREDENTIALS='{"type":"service_account",...}' -- uvx google-analytics-4-mcp

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-4-mcp"],
      "env": {
        "GA_CREDENTIALS": "{\"type\":\"service_account\",\"project_id\":\"...\", ...}"
      }
    }
  }
}

ソースからインストール

git clone https://github.com/stucchi/mcp-google-analytics.git
cd mcp-google-analytics
uv run google-analytics-4-mcp

はじめに

1. 認証を確認する：check_auth_status を呼び出し、サービスアカウントが設定されていることを確認します
2. アカウントを一覧表示する：list_accounts を呼び出し、GA4 アカウントを確認します
3. プロパティを設定する：create_property → create_web_data_stream → get_tracking_snippet を使用します
4. データをクエリする：ディメンションと指標を指定して run_report を使用します

ツール（23）

認証

ツール	説明
check_auth_status	サービスアカウントが設定され、有効であることを確認します

Admin API

ツール	説明
list_accounts	アクセス可能な GA4 アカウントを一覧表示します
list_properties	アカウントのプロパティを一覧表示します
create_property	GA4 プロパティを作成します
get_property	プロパティの詳細を取得します
delete_property	プロパティを論理削除します
list_data_streams	データストリームを一覧表示します
create_web_data_stream	ウェブストリームを作成し、測定 ID を取得します
delete_data_stream	データストリームを削除します
get_tracking_snippet	gtag.js の HTML スニペットを生成します
list_key_events	コンバージョンイベントを一覧表示します
create_key_event	イベントをコンバージョンとして設定します
delete_key_event	コンバージョンを削除します
list_custom_dimensions	カスタムディメンションを一覧表示します
create_custom_dimension	カスタムディメンションを作成します
list_custom_metrics	カスタム指標を一覧表示します
create_custom_metric	カスタム指標を作成します
list_google_ads_links	Google Ads のリンクを一覧表示します
create_google_ads_link	Google Ads アカウントをリンクします
get_measurement_protocol_secret	Measurement Protocol シークレットを取得または作成します

Data API

ツール	説明
run_report	ディメンション、指標、日付、フィルターを指定してレポートを実行します
run_realtime_report	リアルタイムのアクティブユーザー数とイベントを取得します
get_metadata	利用可能なディメンションと指標を一覧表示します

環境変数

変数	デフォルト	説明
GA_CREDENTIALS	—	サービスアカウントの JSON キーの内容（JSON 全体をコピーして貼り付けます）
GA_CREDENTIALS_PATH	~/.google-analytics-4-mcp/credentials.json	代替設定：JSON キーファイルへのパス

GA_CREDENTIALS は GA_CREDENTIALS_PATH より優先されます。

使用例

You: "Set up Google Analytics for my website https://mcpadvisor.stucchi.consulting"

Assistant calls: list_accounts → create_property → create_web_data_stream → get_tracking_snippet

Result: Property created with Measurement ID G-XXXXXXXXXX and ready-to-paste HTML snippet.

You: "Show me the top 10 countries by sessions in the last 7 days"

Assistant calls: run_report(property_id="...", dimensions=["country"], metrics=["sessions"], start_date="7daysAgo", limit=10)

ライセンス

MIT