2026/3/28 4 min read

Google Analytics MCP で Claude Code から GA4 データを引き出す

Google が公開した Google Analytics MCP サーバーを Claude Code に接続して、ターミナルから GA4 のデータを取得できるようにした。ついでにスキルも作って /ga-report 一発でレポートが出るようにした。

Google Analytics MCP とは

MCP（Model Context Protocol）は、AI エージェントが外部ツールと連携するためのプロトコル。Google Analytics MCP サーバーはこのプロトコルを実装していて、GA4 の Admin API と Data API を AI エージェントから呼び出せるようにする。

使えるツールは7つ。

ツール	用途
`get_account_summaries`	アカウント・プロパティ一覧
`get_property_details`	プロパティの詳細情報
`get_custom_dimensions_and_metrics`	カスタムディメンション・指標
`list_google_ads_links`	Google Ads 連携情報
`list_property_annotations`	アノテーション一覧
`run_report`	レポート実行（過去データ）
`run_realtime_report`	リアルタイムレポート

すべて読み取り専用で、analytics.readonly スコープで動作する。

セットアップ

GCP の準備

GA4 の Admin API と Data API を有効化する。

gcloud services enable analyticsadmin.googleapis.com analyticsdata.googleapis.com \
  --project=YOUR_PROJECT_ID

OAuth クライアントの作成

GCP コンソールで OAuth クライアントを作成する。

OAuth 同意画面を設定（外部、テストユーザーに自分を追加）
認証情報 → OAuth クライアント ID → デスクトップアプリ
JSON をダウンロード

認証

gcloud auth application-default login \
  --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

analytics-mcp のインストール

公式は pipx run を推奨しているが、初回のダウンロードが遅くて MCP サーバーの起動タイムアウトに引っかかった。事前にインストールしておくのが確実。

pipx install analytics-mcp

Claude Code への接続

~/.claude.json の mcpServers に追加する。

{
  "mcpServers": {
    "analytics-mcp": {
      "type": "stdio",
      "command": "/Users/you/.local/bin/analytics-mcp",
      "args": [],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/you/.config/gcloud/application_default_credentials.json",
        "GOOGLE_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Claude Code を再起動して /mcp で analytics-mcp が表示されれば接続完了。

使ってみる

アカウント一覧の取得。

> GA4 のアカウント一覧を見せて

アカウント: ota2000
  プロパティ: ota2000.com (properties/530272485)

リアルタイムレポート。

> 今アクティブなユーザーは？

日本から2名がアクティブです。

過去データのレポート。ディメンションと指標を組み合わせて自由にクエリできる。

> 今日のページ別 PV を教えて

| ページ | PV | ユーザー | セッション |
|---|---|---|---|
| / | 15 | 3 | 3 |
| /blog/dlt-community-sources/ | 1 | 1 | 1 |

デバイス別、流入元、ブラウザ、地域、エンゲージメント（直帰率・滞在時間）なども取得できる。

スキルを作る

毎回「ページ別 PV を見せて」と打つのは面倒なので、Claude Code のスキルとして定義した。.claude/skills/ga-report/SKILL.md にプロパティ ID やデフォルトのレポート定義を書いておく。

---
name: ga-report
description: GA4 レポート取得。ota2000.com のアクセス状況をレポートする。
---

スキルの中身には、引数なしで呼ばれた場合に並列実行するレポートを定義した。

リアルタイムのアクティブユーザー数
過去7日間のページ別 PV
過去7日間の日別 PV
過去7日間の流入元
過去7日間のデバイス別

/ga-report と打つだけで、これらが一括で返ってくる。期間指定（/ga-report 30d）や詳細モード（/ga-report detail）にも対応させた。

スキルをプロジェクトローカルに置く理由

Claude Code のスキルは ~/.claude/skills/（グローバル）と .claude/skills/（プロジェクト）の2箇所に置ける。GA4 のプロパティ ID やブログの文体ルールは ota2000.com 固有なので、プロジェクトローカルに置いた。git で差分が追えるし、他のプロジェクトに影響しない。