A Model Context Protocol (MCP) server for comprehensive Google Analytics API access. Built with FastMCP and maintained by Locomotive Agency for use with mcpanywhere.com.

This server provides access to the Google Analytics Admin API and Google Analytics Data API through MCP tools for LLM integration.

The server provides the following MCP tools:

• get_account_summaries - Retrieves information about Google Analytics accounts and properties
• get_property_details - Returns details about a specific property
• list_google_ads_links - Lists Google Ads account links for a property

• run_report - Runs a Google Analytics report using the Data API
• get_custom_dimensions_and_metrics - Retrieves custom dimensions and metrics for a property

• run_realtime_report - Runs a Google Analytics realtime report using the Data API

uv tool install google-analytics-mcp-python

pip install google-analytics-mcp-python

pipx install google-analytics-mcp-python

Enable the following APIs in your Google Cloud project:

• Google Analytics Admin API
• Google Analytics Data API

1. Go to the Google Cloud Console
2. Create a service account with the Analytics API scope
3. Download the JSON key file

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

If you need to access Analytics properties on behalf of a user:

export ANALYTICS_MCP_SUBJECT="[email protected]"

Note: For backward compatibility, GOOGLE_IMPERSONATED_SUBJECT is also supported.

Required OAuth scope:

https://www.googleapis.com/auth/analytics.readonly

Add to your MCP settings file (~/.gemini/settings.json or Claude Desktop config):

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp-python"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json",
        "ANALYTICS_MCP_SUBJECT": "[email protected]"
      }
    }
  }
}

Example Dockerfile for containerized deployment:

FROM python:3.12-slim

RUN pip install --no-cache-dir google-analytics-mcp-python

ENV GOOGLE_APPLICATION_CREDENTIALS=/var/secrets/service-account.json

CMD ["google-analytics-mcp"]

Required environment variables:

• GOOGLE_APPLICATION_CREDENTIALS - Path to service account JSON
• ANALYTICS_MCP_SUBJECT (optional) - User email for domain-wide delegation

Once configured, you can interact with your Google Analytics data:

What are the most popular events in my Google Analytics property in the last 180 days?

Give me details about my Google Analytics property with 'xyz' in the name

What are the custom dimensions and custom metrics in my property?

Were most of my users in the last 6 months logged in?

This server is maintained by Locomotive Agency as part of the MCP Anywhere ecosystem.

Original implementation by Google Analytics team. Enhanced with domain-wide delegation support for enterprise use cases.

Apache License 2.0 - See LICENSE file for details.

Contributions welcome! See the Contributing Guide.