Skip to main content
Glama
Shin-sibainu

GA4 MCP Server

by Shin-sibainu
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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 でサービスアカウントを作成

  1. Google Cloud Console にアクセス

  2. プロジェクトを選択（または新規作成）

  3. 「IAM と管理」→「サービスアカウント」→「サービスアカウントを作成」

  4. 名前を入力して作成

  5. 「キー」タブ →「鍵を追加」→「新しい鍵を作成」→ JSON形式でダウンロード

2. API の有効化

「APIとサービス」→「ライブラリ」で以下を有効化:

  • Google Analytics Data API

  • Google Analytics Admin API

3. GA4 プロパティへのアクセス権付与

  1. Google Analytics にアクセス

  2. 「管理」→「プロパティのアクセス管理」

  3. サービスアカウントのメールアドレス（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)

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop (Windows)

%APPDATA%\Claude\claude_desktop_config.json

Cursor

.cursor/mcp.json

（プロジェクトルート）

環境変数

変数名

必須

説明

GOOGLE_APPLICATION_CREDENTIALS

×

サービスアカウントJSONキーのパス（gcloud CLI使用時は不要）

GA4_PROPERTY_ID

△

デフォルトのGA4プロパティID（ツール実行時に指定も可）

利用可能なツール

基本ツール（5個）

ツール名

説明

list_accounts

アカウント・プロパティ一覧取得

get_property_details

プロパティ詳細情報

run_report

汎用レポート実行（メインツール）

run_realtime_report

リアルタイムレポート

get_metadata

利用可能なディメンション・メトリクス一覧

分析ツール（15個）

ツール名

説明

get_traffic_summary

トラフィックサマリー（PV/UU/セッション等）

get_top_pages

人気ページランキング

get_traffic_sources

流入元分析

get_device_breakdown

デバイス別アクセス比率

get_geo_breakdown

地域別アクセス分析

compare_periods

期間比較（前週比、前月比など）

get_landing_pages

ランディングページ分析

get_exit_pages

離脱ページ分析

get_user_journey

ユーザージャーニー（ページ遷移）

get_conversion_funnel

コンバージョンファネル分析

get_hourly_traffic

時間帯別アクセス分析

get_daily_trend

日別トレンド

get_new_vs_returning

新規 vs リピーター分析

get_engagement_metrics

エンゲージメント指標

get_search_terms

サイト内検索キーワード

使用例

基本的な質問

「今日の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

注意事項

  1. レート制限: GA4 Data API には 1 プロジェクトあたり 1 日 50,000 リクエストの制限があります

  2. データの遅延: GA4のデータは通常24-48時間の遅延があります（リアルタイムレポートを除く）

  3. ファネル分析の制限: GA4 Data APIでは真のファネル分析に制限があります。より正確な分析にはBigQuery Exportが必要です

ライセンス

MIT

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Shin-sibainu/ga4-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server