Google Analytics MCP

Google Analytics 4向けのローカルMCPサーバー。SEOおよび有料広告レポートに焦点を当てたツールでGA4 Data APIをラップします。

ツール

セットアップ

git clone https://github.com/ZLeventer/google-analytics-mcp-server.git
cd google-analytics-mcp-server
npm install
npm run build

認証情報

.env.example を .env にコピーし、以下を入力します：

• GA4_PROPERTY_ID — GA4管理画面 → プロパティ設定から取得できる数値のプロパティID（例: 123456789）。測定ID（G-XXXXXXX）ではありません。

• GOOGLE_APPLICATION_CREDENTIALS — サービスアカウントJSONキーファイルへの絶対パス。

サービスアカウントの作成

1. console.cloud.google.com にアクセス → プロジェクトを選択/作成

2. APIとサービス → ライブラリ → Google Analytics Data API を有効化

3. IAMと管理 → サービスアカウント → サービスアカウントを作成（名前を ga4-mcp などにする）

4. 作成したアカウントで → キー → 鍵を追加 → 新しい鍵を作成 → JSON → ダウンロード

5. このディレクトリにJSONを service-account.json として保存（.gitignore に追加済み）

6. GA4 → 管理 → プロパティのアクセス管理 で + をクリック → サービスアカウントのメールアドレス（ga4-mcp@project-id.iam.gserviceaccount.com）を貼り付け → 閲覧者 を割り当て

Google SDKは GOOGLE_APPLICATION_CREDENTIALS を自動的に読み込むため、コードの変更は不要です。

Claude Codeへのインストール

claude mcp add google-analytics \
  --env-file "/absolute/path/to/google-analytics-mcp-server/.env" \
  -- node "/absolute/path/to/google-analytics-mcp-server/dist/index.js"

または、~/.claude.json に手動で追加します：

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/google-analytics-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/google-analytics-mcp-server/service-account.json"
      }
    }
  }
}

インストール後、Claude Codeを再起動してください。

日付形式

すべての日付引数はGA4形式を受け付けます：

• YYYY-MM-DD（例: 2026-04-01）

• NdaysAgo（例: 28daysAgo, 90daysAgo）

• yesterday, today

デフォルト: 28daysAgo → yesterday。

検証

認証情報の設定後：

node -e '
  import("./dist/tools/reports.js").then(m =>
    m.channelPerformance({ start_date: "7daysAgo", end_date: "yesterday", limit: 10 })
  ).then(r => console.log(JSON.stringify(r, null, 2)))
'

行が返されれば、すべて正常に動作しています。想定されるエラー：

• GA4_PROPERTY_ID is not set — .env を確認してください

• PERMISSION_DENIED — サービスアカウントにプロパティの閲覧者権限が付与されていません

• 403 Google Analytics Data API has not been used — GCPプロジェクトでAPIを有効にしてください

ロードマップ

• [ ] 必要に応じて管理APIツール（カスタムディメンション、コンバージョンイベント、オーディエンスの一覧表示）

• [ ] ランキング/インプレッション/CTRデータ用の兄弟サーバーとしてのSearch Console MCP（本サーバーを補完）

• [ ] Demandbase MCPと組み合わせて、GA4のトラフィックと企業属性（アカウントレベルの属性）を結合