Skip to main content
Glama
PlatAid

Google Analytics MCP

by PlatAid
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Google Analytics MCP (shared, per-user OAuth)

A GCP-hosted MCP server for Google Analytics (GA4) where each user logs in with their own Google account and queries are scoped to that user's GA permissions — no shared service-account, no server-held keys, no ACL table.

It re-hosts the official analytics-mcp tools under FastMCP so we get streamable-HTTP + Google OAuth — the same pattern as the official Google Ads MCP and the sibling Naver Search Ads MCP.

How it works

Claude (each teammate) ──streamable-HTTP + Google OAuth (analytics.readonly)──▶
  FastMCP server (Cloud Run)
    ├ GoogleProvider  : brokers Google login, forwards the user's Google token
    ├ credential shim : each request → Credentials(token=<user's Google token>)
    └ analytics-mcp   : 9 GA tools, now running as the calling user
        └─▶ GA Admin/Data API  (returns only what that user may see)

The one swap that makes it per-user: analytics_mcp.tools.client._get_credentials is replaced (in server.py) with a resolver that reads the current request's Google token via fastmcp.server.dependencies.get_access_token(). When there is no authenticated request (local stdio), it falls back to Application Default Credentials.

Related MCP server: Google MCP Server

Tools (all read-only)

get_account_summaries, get_property_details, list_google_ads_links, list_property_annotations, get_custom_dimensions_and_metrics, run_report, run_realtime_report, run_funnel_report, run_conversions_report.

Local dev (stdio, ADC)

uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -e .
# Uses your gcloud ADC. GA_MCP_TRANSPORT defaults to stdio, no OAuth.
GA_MCP_TRANSPORT=stdio .venv/bin/google-analytics-mcp

Hosted (Cloud Run, per-user OAuth)

See DEPLOY.md. In short: create an Internal OAuth Web client (with the analytics.readonly scope on the consent screen), store the secret in Secret Manager, then run deploy/deploy.sh.

Environment

Var

Purpose

GA_MCP_TRANSPORT

stdio (local) or http (hosted)

GA_OAUTH_CLIENT_ID / GA_OAUTH_CLIENT_SECRET

Google OAuth Web client. Presence activates OAuth.

PUBLIC_BASE_URL

Cloud Run HTTPS URL (OAuth redirect base; callback /auth/callback).

GA_OAUTH_HD

Workspace domain hint (e.g. yourcompany.com).

GA_OAUTH_JWT_KEY

Stable key so issued tokens survive redeploys.

GCP_PROJECT_ID

Enables Firestore OAuth-state persistence.

GA_OAUTH_FIRESTORE_DATABASE / GA_OAUTH_FIRESTORE_COLLECTION

Firestore location for OAuth state.

Connect (teammates)

claude mcp add --transport http google-analytics <PUBLIC_BASE_URL>/mcp
# first use opens the browser for Google login

Credits

  • The 9 GA tools come from Google's official analytics-mcp (Apache-2.0). This project imports them and overrides only the credential resolver so each request runs as the calling user.

  • OAuth + streamable-HTTP transport are provided by FastMCP (Apache-2.0).

See NOTICE for attribution details.

License

Apache-2.0.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-gtm-ga4

    mharnett
    A
    license
    A
    quality
    A
    maintenance
    MCP server for Google Tag Manager and GA4, enabling tag management, consent auditing, workspace versioning, and analytics reporting through natural language.
    11
    49 npm
    2
    MIT

  • Google MCP Server

    kairos-company
    A
    license
    Not graded
    quality
    D
    maintenance
    A unified MCP server that gives AI assistants direct access to Google Analytics 4, Google Search Console, Google Ads and Google Merchant Center data using OAuth2 user credentials.
    MIT

  • bigquery-mcp

    aicayzer
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for secure BigQuery access across multiple Google Cloud projects, enabling querying, schema exploration, and data analysis with SQL validation and read-only controls.
    2
    MIT

  • analytics-mcp

    adtechnacity
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for querying Google Analytics accounts, properties, reports, and realtime data using the Data API and Admin API.
    Apache 2.0