Ruchernchong MCP Server Google Analytics

🚀 Google Analytics 4 MCP Server

An implementation based on the Model Context Protocol (MCP) for accessing Google Analytics 4 (GA4) data via the TypeScript SDK.

✨ Features

• Retrieve page view metrics with customizable dimensions.
• Track active and new users over a period of time.
• Analyze specific events and their metrics.
• Monitor user behavior metrics (session duration, bounce rate).
• All queries support flexible time range selection.

📋 Prerequisites

• Node.js 20 or higher.
• A Google Analytics 4 account property.
• A Google Cloud project with the Analytics Data API enabled.
• Service account credentials with appropriate permissions.

📦 Installation

pnpm install mcp-server-google-analytics

💻 Usage Examples

Start the Server

pnpm start

Configuration in Claude Desktop

Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-server-google-analytics"],
      "env": {
        "GOOGLE_CLIENT_EMAIL": "your-service-account@project.iam.gserviceaccount.com",
        "GOOGLE_PRIVATE_KEY": "your-private-key",
        "GA_PROPERTY_ID": "your-ga4-property-id"
      }
    }
  }
}

Available Functions

getPageViews

Retrieve page view metrics for a specific time period:

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": ["page", "country"] // Optional
}

getActiveUsers

Retrieve active user metrics:

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

getEvents

Retrieve event metrics:

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "eventName": "purchase" // Optional
}

getUserBehavior

Retrieve user behavior metrics:

{
  "startDate": "2024-01-01",
  "endDate": "2024-01-31"
}

⚠️ Security Considerations

• Always store sensitive credentials using environment variables.
• Implement appropriate CORS settings.
• Set service account permissions following the principle of least privilege.
• Rotate service account credentials regularly.
• Monitor API usage and implement rate limiting as needed.

🤝 Contributing to the Project

Contributions are welcome! Please read our Contributing Guide for code standards and the process of submitting a Pull Request.

📄 License

This project is open-source under the MIT License. Please refer to the LICENSE file for detailed information.