Provides 20 analysis tools for retrieving and analyzing Google Analytics 4 (GA4) data, including traffic summaries, page rankings, traffic sources, device breakdowns, geographic analysis, period comparisons, user journeys, conversion funnels, engagement metrics, and real-time reporting.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GA4 MCP Server過去7日間のアクセス数が多いページTOP10を教えて"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GA4 MCP Server
Google Analytics 4 (GA4) のデータを Claude などの LLM から取得・分析できる MCP (Model Context Protocol) サーバーです。
特徴
20種類の分析ツール: 単純なデータ取得だけでなく、実用的な分析ツールを多数搭載
日本語対応: 出力結果は日本語でフォーマット（例: "2分34秒", "45.2%"）
柔軟な期間指定: 相対日付（
7daysAgo,yesterday）と絶対日付の両方に対応即座にインサイト: LLMが直接解釈しやすい形式でデータを返却
必要要件
Node.js 18以上
GA4 プロパティへのアクセス権を持つ Google アカウント
インストール
cd ga4-mcp-server
npm install
npm run build認証設定
方法1: gcloud CLI を使う（推奨・簡単）
サービスアカウント不要で、自分の Google アカウントで認証できます。
1. gcloud CLI をインストール
# Windows (winget)
winget install Google.CloudSDK
# または https://cloud.google.com/sdk/docs/install からダウンロード2. 認証を実行
gcloud auth application-default login --scopes="https://www.googleapis.com/auth/analytics.readonly"ブラウザが開くので、GA4 にアクセス権のある Google アカウントでログインするだけ！
これだけで完了です。GOOGLE_APPLICATION_CREDENTIALS の設定は不要です。
方法2: サービスアカウントを使う（本番環境向け）
チーム共有や本番環境では、サービスアカウントを使用します。
1. Google Cloud Console でサービスアカウントを作成
Google Cloud Console にアクセス
プロジェクトを選択（または新規作成）
「IAM と管理」→「サービスアカウント」→「サービスアカウントを作成」
名前を入力して作成
「キー」タブ →「鍵を追加」→「新しい鍵を作成」→ JSON形式でダウンロード
2. API の有効化
「APIとサービス」→「ライブラリ」で以下を有効化:
Google Analytics Data API
Google Analytics Admin API
3. GA4 プロパティへのアクセス権付与
Google Analytics にアクセス
「管理」→「プロパティのアクセス管理」
サービスアカウントのメールアドレス（
xxx@xxx.iam.gserviceaccount.com）を「閲覧者」として追加
MCP 設定
gcloud CLI 認証を使う場合（推奨）
{
"mcpServers": {
"ga4": {
"command": "node",
"args": ["/path/to/ga4-mcp-server/dist/index.js"],
"env": {
"GA4_PROPERTY_ID": "123456789"
}
}
}
}サービスアカウントを使う場合
{
"mcpServers": {
"ga4": {
"command": "node",
"args": ["/path/to/ga4-mcp-server/dist/index.js"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
"GA4_PROPERTY_ID": "123456789"
}
}
}
}設定ファイルの場所
アプリ | 設定ファイル |
Claude Desktop (Mac) |
|
Claude Desktop (Windows) |
|
Cursor |
|
環境変数
変数名 | 必須 | 説明 |
| × | サービスアカウントJSONキーのパス（gcloud CLI使用時は不要） |
| △ | デフォルトのGA4プロパティID（ツール実行時に指定も可） |
利用可能なツール
基本ツール（5個）
ツール名 | 説明 |
| アカウント・プロパティ一覧取得 |
| プロパティ詳細情報 |
| 汎用レポート実行（メインツール） |
| リアルタイムレポート |
| 利用可能なディメンション・メトリクス一覧 |
分析ツール（15個）
ツール名 | 説明 |
| トラフィックサマリー（PV/UU/セッション等） |
| 人気ページランキング |
| 流入元分析 |
| デバイス別アクセス比率 |
| 地域別アクセス分析 |
| 期間比較（前週比、前月比など） |
| ランディングページ分析 |
| 離脱ページ分析 |
| ユーザージャーニー（ページ遷移） |
| コンバージョンファネル分析 |
| 時間帯別アクセス分析 |
| 日別トレンド |
| 新規 vs リピーター分析 |
| エンゲージメント指標 |
| サイト内検索キーワード |
使用例
基本的な質問
「今日のPV数を教えて」
→ get_traffic_summary (period: "today")
「今リアルタイムで何人見てる？」
→ run_realtime_reportランキング系
「過去7日間のアクセス数が多いページTOP10」
→ get_top_pages (period: "7days", limit: 10)
「どこからアクセスが来てる？」
→ get_traffic_sources (period: "7days", groupBy: "channel")比較・分析系
「先週と今週を比較して」
→ compare_periods (comparisonType: "previousPeriod", period: "7days")
「モバイルとPCの比率は？」
→ get_device_breakdown (period: "7days")深堀り分析
「何時頃にアクセスが多い？」
→ get_hourly_traffic (period: "7days")
「このページを見た人は次にどこに行く？」
→ get_user_journey (pagePath: "/product/123", direction: "next")開発
# 開発モード（ファイル変更を監視してリビルド）
npm run dev
# ビルド
npm run build
# 型チェック
npm run typecheck注意事項
レート制限: GA4 Data API には 1 プロジェクトあたり 1 日 50,000 リクエストの制限があります
データの遅延: GA4のデータは通常24-48時間の遅延があります（リアルタイムレポートを除く）
ファネル分析の制限: GA4 Data APIでは真のファネル分析に制限があります。より正確な分析にはBigQuery Exportが必要です
ライセンス
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.