Google Analytics Data API MCP Server

Provides an interface for accessing the Google Analytics Data API using a Model Context Protocol (MCP) server.

function

This MCP server provides the tools and resources to access key features of the Google Analytics Data API:

tool

• get_report : Retrieves a report based on a specified date range, metric, and dimension

• get_realtime_data : Get real-time data

resource

• ga4://property/{propertyId}/metadata : Access the metadata of a Google Analytics property

Related MCP server: Policy Analyzer API MCP Server

set up

Prerequisites

1. Create a Google Cloud project and enable the Analytics Data API.

2. Create a service account and download the credentials JSON file

3. Give the service account the appropriate access to your GA4 property

For detailed setup instructions, please see the Setup Guide .

install

# リポジトリをクローン
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics

# 依存関係をインストール
npm install

# ビルド
npm run build

Setting environment variables

The following environment variables must be set:

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"

How to use

Starting the Server

npm start

Alternatively, you can use the provided script:

./run-server.sh

Claude Desktop settings

Add the following to your Claude Desktop config file:

{
  "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"
      }
    }
  }
}

For a detailed configuration example, see claude-desktop-config-sample.json .

Examples of using the tool

Get the report

get_report ツールを使用して、過去7日間のアクティブユーザー数とページビュー数を取得します。

引数:
{
  "startDate": "7daysAgo",
  "endDate": "today",
  "metrics": ["activeUsers", "screenPageViews"],
  "dimensions": ["date"],
  "limit": 10
}

Get real-time data

get_realtime_data ツールを使用して、現在アクティブなユーザー数を取得します。

引数:
{
  "metrics": ["activeUsers"],
  "dimensions": ["deviceCategory"],
  "limit": 10
}

Resource usage examples

ga4://property/123456789/metadata リソースにアクセスして、利用可能なメトリクスとディメンションを確認します。

Usage Example

For an example of usage with Claude, see Claude Usage Example .

license

MIT