MCP Server Google Analytics

🚀 Google Analytics MCP Server

An MCP server implemented with a TypeScript SDK based on the Model Context Protocol (MCP) for accessing Google Analytics 4 (GA4) data.

✨ Features

• Retrieve page view metrics with customizable dimensions.
• Track active and new users within a specific time frame.
• Analyze specific events and their metrics.
• Monitor user behavior metrics (session duration, bounce rate).
• Support flexible time range selection for all queries.

📦 Installation

Prerequisites

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

Installation and Configuration

1. Create a Google Cloud project and enable the Analytics Data API.
2. Create a service account and download the credentials JSON file.
3. Grant the service account access to your GA4 property.
4. Set the 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"

Installation Methods

Automatic Installation via Smithery

Automatically install the Google Analytics server through Smithery:

npx -y @smithery/cli install mcp-server-google-analytics --client claude

Manual Installation

pnpm install mcp-server-google-analytics

💻 Usage Examples

Starting the Server

pnpm start

Configuring 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 within a specific time frame:

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

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 parameter
}

getUserBehavior

Retrieve user behavior metrics:

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

🔧 Technical Details

Security Precautions

• 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 limits if necessary.

🤝 Contribution Guidelines

Contributions are welcome! Please read our Contribution Guidelines to learn how to get involved.

📄 License

• LICENSE
• README.md
• CONTRIBUTING.md