Provides tools for accessing Google Analytics Data API, allowing retrieval of analytics reports with custom metrics, dimensions, and date ranges, as well as real-time data from GA4 properties.
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., "@Google Analytics Data API MCP Servershow me active users for the past week"
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.
Google Analytics Data API MCP Server
Model Context Protocol (MCP) サーバーを使用して、Google Analytics Data APIにアクセスするためのインターフェースを提供します。
機能
このMCPサーバーは、Google Analytics Data APIの主要な機能にアクセスするためのツールとリソースを提供します：
ツール
get_report: 指定した日付範囲、メトリクス、ディメンションに基づいてレポートを取得します
get_realtime_data: リアルタイムデータを取得します
リソース
ga4://property/{propertyId}/metadata: Google Analyticsプロパティのメタデータにアクセスします
Related MCP server: Policy Analyzer API MCP Server
セットアップ
前提条件
Google Cloudプロジェクトを作成し、Analytics Data APIを有効にします
サービスアカウントを作成し、認証情報JSONファイルをダウンロードします
サービスアカウントにGA4プロパティへの適切なアクセス権を付与します
詳細なセットアップ手順については、セットアップガイドを参照してください。
インストール
# リポジトリをクローン
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics
# 依存関係をインストール
npm install
# ビルド
npm run build環境変数の設定
以下の環境変数を設定する必要があります：
export GOOGLE_CLIENT_EMAIL="your-service-account@project.iam.gserviceaccount.com"
export GOOGLE_PRIVATE_KEY="your-private-key"
export GA_PROPERTY_ID="your-ga4-property-id"使用方法
サーバーの起動
npm startまたは、提供されているスクリプトを使用することもできます：
./run-server.shClaude Desktopでの設定
Claude Desktopの設定ファイルに以下を追加します：
{
"mcpServers": {
"google-analytics": {
"command": "node",
"args": ["/path/to/mcp-server-google-analytics/build/index.js"],
"env": {
"GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
"GOOGLE_PRIVATE_KEY": "your-private-key",
"GA_PROPERTY_ID": "your-ga4-property-id"
}
}
}
}詳細な設定例については、claude-desktop-config-sample.jsonを参照してください。
ツールの使用例
レポートの取得
get_report ツールを使用して、過去7日間のアクティブユーザー数とページビュー数を取得します。
引数:
{
"startDate": "7daysAgo",
"endDate": "today",
"metrics": ["activeUsers", "screenPageViews"],
"dimensions": ["date"],
"limit": 10
}リアルタイムデータの取得
get_realtime_data ツールを使用して、現在アクティブなユーザー数を取得します。
引数:
{
"metrics": ["activeUsers"],
"dimensions": ["deviceCategory"],
"limit": 10
}リソースの使用例
ga4://property/123456789/metadata リソースにアクセスして、利用可能なメトリクスとディメンションを確認します。使用例
Claudeでの使用例については、Claude使用例を参照してください。
ライセンス
MIT