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

set up

Prerequisites

Create a Google Cloud project and enable the Analytics Data API.
Create a service account and download the credentials JSON file
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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides an interface to access Google Analytics Data API through Model Context Protocol (MCP), allowing users to retrieve reports and realtime data from Google Analytics 4 properties.

Related MCP Servers

mcp-server-google-analytics
ruchernchong
-
security
A
license
-
quality
An MCP server implementation for accessing Google Analytics 4 (GA4) data, built using the Model Context Protocol TypeScript SDK.
Last updated -
131
67
JavaScript
MIT License
Spreadsheet MCP Server
HosakaKeigo
A
security
F
license
A
quality
Provides a Model Context Protocol (MCP) server that enables LLMs to directly access and interact with Google Spreadsheet data.
Last updated -
2
1
TypeScript
Policy Analyzer API MCP Server
ag2-mcp-servers
-
security
F
license
-
quality
This MCP Server provides a natural language interface to interact with Google's Policy Analyzer API, allowing users to analyze policies and evaluate compliance through conversations.
Last updated -
Python
MCP Search Analytics Server
dexter480
-
security
F
license
-
quality
A Model Context Protocol server that provides unified access to Google Analytics 4 and Google Search Console data through real-time analytics queries.
Last updated -
2
Python

View all related MCP servers

Google Analytics Data API MCP Server