Eno Graph MCP Server Google Analytics

🚀 Google Analytics Data API MCP Server

The Model Context Protocol (MCP) server provides interfaces to access the Google Analytics Data API, offering a convenient way to retrieve and analyze Google Analytics data.

✨ Features

This MCP server offers tools and resources to access the main functions of the Google Analytics Data API:

Tools

• get_report: Retrieve reports based on specified date ranges, metrics, and dimensions.
• get_realtime_data: Obtain real-time data.

Resources

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

📦 Installation

Prerequisites

1. Create a Google Cloud project and enable the Analytics Data API.
2. Create a service account and download the authentication information JSON file.
3. Grant the service account appropriate access to the GA4 property.

For detailed installation steps, please refer to the Setup Guide.

Installation Steps

# Clone the repository
git clone https://github.com/eno-graph/mcp-server-google-analytics.git
cd mcp-server-google-analytics

# Install dependencies
npm install

# Build the project
npm run build

Environment Variable Configuration

You need to set the following environment variables:

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"

Server Startup

npm start

Or use the provided script:

./run-server.sh

Claude Desktop Configuration

Add the following content to the Claude Desktop settings 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 detailed configuration examples, please refer to claude-desktop-config-sample.json.

💻 Usage Examples

Basic Usage

Using the get_report Tool

Retrieve the number of active users and page views in the past 7 days:

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

Using the get_realtime_data Tool

Retrieve the current number of active users:

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

Advanced Usage

Access the following resource to check available metrics and dimensions:

ga4://property/123456789/metadata

Example Use Cases

For usage examples in Claude, please refer to Claude Usage Examples.

📄 License

This project is licensed under the MIT license.