Google Analytics MCP Server

Google Analytics MCP Server とは？

Google Analytics MCP Server（google-analytics-mcp）は、Google Analytics 4 のデータを Claude、Cursor、VS Code などの MCP クライアントにつなぐ、コミュニティ製の google analytics mcp サーバーです。トラフィック、チャネル、コンバージョンについて自然言語で質問すると、GA4 Data API の読み取り専用レポートを実行します。

メンテナンスは surendranb で、ライセンスは MIT です。PyPI では google-analytics-mcp、npm では @surendranb/google-analytics-mcp として公開されています。GA4 Data API の上に、スキーマのライブ検出、サーバー側集計、組み込みの分析「skills」を追加しています。Google 自身のサーバーではありません。Google は別に実験版の公式 Google Analytics MCP サーバーを公開しています。

Google Analytics MCP Server の使い方

前提条件： Python 3.10+（npm ラッパーを使う場合は Node.js）、データのある GA4 プロパティ、Google Cloud の認証情報。

1. 認証情報を作成します。 Google Cloud Console でプロジェクトを選び、Google Analytics Data API を有効にします。サービスアカウントを作成し、JSON キーをダウンロードします。gcloud auth application-default login でアプリケーションのデフォルト認証情報（ADC）を使うこともできます。
2. GA4 でアクセス権を付与します。 JSON キーの client_email をコピーします。Google Analytics で Admin → Property Access Management → Add users を開き、そのメールアドレスを貼り付けて Viewer ロールを選びます。
3. プロパティ ID を控えます。 Admin → Property details にある数字の GA4_PROPERTY_ID を使います。G- で始まる測定 ID ではありません。
4. 環境変数を 2 つ設定します： GA4_PROPERTY_ID と、JSON キーの絶対パスを指す GOOGLE_APPLICATION_CREDENTIALS。

README には、この ga4 mcp server を動かす方法がいくつか書かれています。

# Universal installer (configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://ga4.builditwithai.xyz/install" | bash

# Or run directly
uvx google-analytics-mcp
npx -y @surendranb/google-analytics-mcp

Claude Code

claude mcp add google-analytics -- uvx google-analytics-mcp

サーバープロセスが GA4_PROPERTY_ID と GOOGLE_APPLICATION_CREDENTIALS を読めるようにしてください。

Claude Desktop

claude_desktop_config.json に次を追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/key.json"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json に同じ設定を使います。Cursor をリロードし、google-analytics が接続済みと表示されることを確認してください。

VS Code

.vscode/mcp.json では、VS Code は servers ブロックを使います。

{
  "servers": {
    "google-analytics": {
      "type": "stdio",
      "command": "uvx",
      "args": ["google-analytics-mcp"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/key.json"
      }
    }
  }
}

プロジェクトのドキュメントには、Codex、Gemini、Copilot、Antigravity、Kiro、OpenCode などのクライアント向けガイドもあります。設定を確認するには「List my GA4 properties.」と聞いてください。

Google Analytics MCP Server の主な機能

• Google Analytics Data API による多次元の GA4 レポート。合計は GA4 が計算し、サーバー側で集計
• 標準・カスタムのディメンションと指標をライブで検出し、モデルがクエリ前にフィールド名を確認できる
• 直近 30 分のアクティブユーザーとイベントを取得するリアルタイムレポート
• traffic-diagnosis、channel-acquisition、ecommerce-analysis、ai-referral-analysis などの組み込み分析プレイブック（skills）
• 読み取り専用で、GA4 の設定は一切変更しない
• uvx、pip、npm ラッパーでローカルに stdio で動作
• 匿名テレメトリーは DO_NOT_TRACK=1 または MCP_TELEMETRY_OPT_OUT=1 でオフにできる

Google Analytics MCP Server のツール

• レポート： get_ga4_data は、ディメンション、指標、期間、行数上限を指定してレポートを実行します。run_realtime_report は直近 30 分のデータを取得します。
• 検出： list_accounts、list_properties、get_property_metadata で、認証情報がアクセスできるアカウントとプロパティ、そしてプロパティの完全なフィールドスキーマを確認できます。クライアント向けガイドには、正しいフィールド名を探す search_schema も紹介されています。
• Skills： skills_list、search_skills、skill_read で、ガイド付きの分析レシピを読み込みます。たとえばトラフィックが落ちたときに順番に確認するチェックリストです。

Google Analytics MCP Server のユースケース

• トラフィック減少の診断：「Why did organic traffic drop in the last 7 days?」
• チャネル別レポート：「What were my top channels last week?」
• 人気コンテンツの特定：「Which pages earned the most engaged sessions last week, excluding bots?」
• AI リファラルの追跡：ChatGPT、Claude、Perplexity、Gemini からのトラフィックを、検索やダイレクトと分けて見る。
• ライブトラフィックの確認：「How many active users are on the site right now, by country?」
• データソースの組み合わせ：作者の Google Search Console MCP と併用し、検索クエリとサイト内の行動を比べる。

Google Analytics MCP Server と代替ツールの比較

• 公式 Google Analytics MCP サーバー（googleanalytics/google-analytics-mcp、Google のドキュメント）：Google が開発し、実験版と表記されています。Apache-2.0 ライセンスで、読み取り専用です。アプリケーションのデフォルト認証情報で Admin API と Data API を使います。Google 自身の実装を使いたい場合はこちらを選んでください。
• このコミュニティ版 google analytics mcp server： スキーマ検証、集計ヘルパー、リアルタイムレポート、プレイブック、複数クライアント対応のインストーラーを備え、頻繁に更新されています。

Google Analytics MCP Server のトラブルシューティング

• 環境変数が足りないというセットアップエラー： クライアントの env ブロックに、GA4_PROPERTY_ID（数字）と GOOGLE_APPLICATION_CREDENTIALS（存在する JSON ファイルの絶対パス）の両方を設定し、クライアントを再起動してください。
• 「The service account does not have Viewer access to the GA4 property」： キー自体は有効ですが、サービスアカウントがプロパティに追加されていません。Property Access Management でその client_email を Viewer として追加してください。プロパティは GA4_PROPERTY_ID と一致するものを選びます。
• 503 Reauthentication is needed： gcloud のアプリケーションのデフォルト認証情報が期限切れです。gcloud auth application-default login を実行してください。
• 400 で無効なディメンション・指標・フィルター： モデルが Universal Analytics 時代の名前を推測しています。search_schema または get_property_metadata で GA4 の名前を調べてから再試行してください。
• Cursor や VS Code でサーバーに接続できない： ターミナルで uvx google-analytics-mcp を実行して実行環境が動くか確認し、コマンドのスペルを確かめてから、ウィンドウをリロードしてください。