Google Analytics MCP Server

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.

Features

The server provides the following MCP tools:

Account & Property Information

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

Core Reports

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

Realtime Reports

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

Installation

Recommended (via uv)

uv tool install google-analytics-mcp-python

Alternative (via pip)

pip install google-analytics-mcp-python

Alternative (via pipx)

pipx install google-analytics-mcp-python

Configuration

1. Enable Google Analytics APIs

Enable the following APIs in your Google Cloud project:

2. Create Service Account

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

3. Set Environment Variables

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

Domain-Wide Delegation (Optional)

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

Usage with MCP Clients

Claude Desktop / Gemini

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]"
      }
    }
  }
}

Docker Deployment

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

Example Prompts

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?

Development

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.

License

Apache License 2.0 - See LICENSE file for details.

Contributing

Contributions welcome! See the Contributing Guide.

Google Analytics MCP Server