Google Analytics Data API MCP Server

by eno-graph

Integrations

  • 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.

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

  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

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. function
    1. tool
    2. resource
  2. set up
    1. Prerequisites
    2. install
    3. Setting environment variables
  3. How to use
    1. Starting the Server
    2. Claude Desktop settings
  4. Examples of using the tool
    1. Get the report
    2. Get real-time data
  5. Resource usage examples
    1. Usage Example
      1. license

        Related MCP Servers

        • -
          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 -
          22
          TypeScript
          MIT License
        • -
          security
          F
          license
          -
          quality
          A specialized Model Context Protocol (MCP) server that integrates Google services (Gmail, Calendar, etc.) into your AI workflows. This server enables seamless access to Google services through MCP, allowing AI agents to interact with Gmail, Google Calendar, and other Google services.
          Last updated -
          10
          3
          TypeScript
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
          Last updated -
          5
          30
          Python
          MIT License
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol (MCP) server that provides intelligent access to PowerPlatform/Dataverse entities and records. This tool offers context-aware assistance, entity exploration and metadata access.
          Last updated -
          466
          1
          JavaScript
          MIT License

        View all related MCP servers

        ID: ntqs86un9v