Google Analytics MCP Server
Allows listing the Google Ads account links associated with a Google Analytics property.
Provides tools for interacting with the Google Analytics Admin API and Data API: retrieving account summaries and property details, running core, funnel, conversions (ad costs, ROAS, attribution), and realtime reports, inspecting custom dimensions/metrics, listing key events and property annotations, and optionally creating annotations, custom dimensions, and key events (with write access enabled).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Google Analytics MCP Server
This repo contains the source code for running a local or remote multi-tenant MCP server that interacts with APIs for Google Analytics.
Join the discussion and ask questions in the π€-analytics-mcp channel on Discord.
Tools π οΈ
The server uses the Google Analytics Admin API and Google Analytics Data API to provide several Tools for use with LLMs.
Retrieve account and property information π
get_account_summaries: Retrieves information about the user's Google Analytics accounts and properties.get_property_details: Returns details about a property.list_google_ads_links: Returns a list of links to Google Ads accounts for a property.list_property_annotations: Returns annotations for a property.create_property_annotation: Creates an annotation for a property (requires passing the--allow-writeflag and theanalytics.editscope).list_key_events: Returns the key events (formerly conversions) defined on a property.create_custom_dimension: Creates a custom dimension on a property (requires passing the--allow-writeflag and theanalytics.editscope, and the Editor role on the property).create_key_event: Marks an event as a key event on a property (requires passing the--allow-writeflag and theanalytics.editscope, and the Marketer or Editor role on the property).
Run core reports π
run_report: Runs a Google Analytics report using the Data API.run_funnel_report: Runs a Google Analytics funnel report using the Data API.run_conversions_report: Runs a Google Analytics conversions report (ad costs, conversions, ROAS and attribution models) using the Data API.get_custom_dimensions_and_metrics: Retrieves the custom dimensions and metrics for a specific property.
Run realtime reports β³
run_realtime_report: Runs a Google Analytics realtime report using the Data API.
Related MCP server: MCP Server for Google Analytics 4
Setup instructions π§
β¨ Watch the Google Analytics MCP Setup Tutorial on YouTube for a step-by-step walkthrough of these instructions.

Setup involves the following steps:
Configure Python.
Configure credentials for Google Analytics.
Configure Gemini.
Configure Python π
Enable APIs in your project β
Follow the instructions to enable the following APIs in your Google Cloud project:
Configure credentials π
Configure your Application Default Credentials (ADC). Make sure the credentials are for a user with access to your Google Analytics accounts or properties.
Credentials must include the Google Analytics read-only scope:
https://www.googleapis.com/auth/analytics.readonlyIf you plan to enable write tools (such as create_property_annotation,
create_custom_dimension or create_key_event) using the --allow-write flag,
your credentials must also include the edit scope:
https://www.googleapis.com/auth/analytics.editWhen using Application Default Credentials, add this scope to the --scopes
value of the gcloud commands below and re-run the login.
Check out Manage OAuth Clients for how to create an OAuth client.
Here are some sample gcloud commands you might find useful:
Set up ADC using user credentials and an OAuth desktop or web client after downloading the client JSON to
YOUR_CLIENT_JSON_FILE.gcloud auth application-default login \ --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \ --client-id-file=YOUR_CLIENT_JSON_FILESet up ADC using service account impersonation.
gcloud auth application-default login \ --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \ --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform
When the gcloud auth application-default command completes, copy the
PATH_TO_CREDENTIALS_JSON file location printed to the console in the
following message. You'll need this for the next step!
Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]Configure Gemini
Install Gemini CLI or Gemini Code Assist.
Create or edit the file at
~/.gemini/settings.json, adding your server to themcpServerslist.Replace
PATH_TO_CREDENTIALS_JSONwith the path you copied in the previous step.We also recommend that you add a
GOOGLE_CLOUD_PROJECTattribute to theenvobject. ReplaceYOUR_PROJECT_IDin the following example with the project ID of your Google Cloud project.{ "mcpServers": { "analytics-mcp": { "command": "pipx", "args": ["run", "analytics-mcp"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON", "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID" } } } }To enable write tools (e.g.
create_property_annotation), append"--allow-write"to"args":["run", "analytics-mcp", "--allow-write"].
Configure Claude Code
Add the MCP server with the following command:
Replace
PATH_TO_CREDENTIALS_JSONwith the path you copied in the previous step, and replaceYOUR_PROJECT_IDwith the project ID of your Google Cloud project.claude mcp add analytics-mcp \ --scope user \ -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" \ -e "GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID" \ -- pipx run analytics-mcp
Multi-tenant HTTP & End-User OAuth π
To host analytics-mcp as a shared multi-tenant HTTP service (where each end
user signs in with their own Google account via OAuth 2.0 rather than using
server-side Application Default Credentials), start the server with
--transport http:
pipx run analytics-mcp \
--transport http --stateless-http --host 0.0.0.0 --port 8080Agent Framework OAuth (e.g. Google ADK): Configure per-user Google OAuth on
McpToolsetso end users are automatically prompted with a Sign in button in the chat UI, and can even combine Google Analytics MCP alongside other MCP servers in the same agent. Paired with--stateless-http, this mode is completely stateless and horizontally scalable across multiple replicas.Native MCP OAuth 2.1 Server (
--oauth): Pass--oauthor setANALYTICS_MCP_OAUTH=true(withGOOGLE_OAUTH_CLIENT_ID,GOOGLE_OAUTH_CLIENT_SECRET, and optionalANALYTICS_MCP_ISSUER_URL) to enable the built-in MCP OAuth 2.1 Authorization Server:export GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com" export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret" export ANALYTICS_MCP_ISSUER_URL="https://analytics-mcp.yourdomain.com" pipx run analytics-mcp \ --transport http --stateless-http --oauth --host 0.0.0.0 --port 8080Note: The built-in
--oauthprovider stores dynamic client registrations, pending authorization state, and refresh tokens in process memory (run as a single instance or with sticky sessions; restarts require re-authentication).
Deploy with Docker & Google Cloud Run π³
The repository includes a root Dockerfile that runs
analytics-mcp in stateless HTTP mode on $PORT (default 8080) as a
non-root user. Server flags can be configured entirely through environment
variables:
Environment Variable | CLI Option | Default | Description |
|
|
| Port to bind when |
|
|
| Handle each HTTP request independently without in-memory session state. |
|
|
| Enable tools that create or modify Google Analytics resources. |
|
|
| Enable the built-in MCP OAuth 2.1 Authorization Server. |
|
|
| Public HTTPS base URL of the service when OAuth is enabled. |
| β | β | Google OAuth 2.0 Web Client ID (required when OAuth is enabled). |
| β | β | Google OAuth 2.0 Web Client Secret (inject via Secret Manager in production). |
Stateless HTTP mode on Cloud Run (for upstream agents like Google ADK that forward per-user Bearer tokens):
gcloud run deploy analytics-mcp \ --source . \ --region us-central1 \ --allow-unauthenticatedNote that
--allow-unauthenticatedexposes the public HTTPS endpoint at the Cloud Run layer, whileanalytics-mcpitself strictly requires a Google OAuth Bearer token on every tool request.Native MCP OAuth 2.1 mode on Cloud Run (storing the client secret in Google Cloud Secret Manager so it is injected as an environment variable at runtime rather than stored in files or source control):
# 1. Store your Google OAuth Client Secret in Secret Manager once printf "%s" "YOUR_CLIENT_SECRET" | \ gcloud secrets create analytics-mcp-oauth-secret --data-file=- # 2. Deploy to Cloud Run (--max-instances=1 keeps in-memory OAuth state consistent) gcloud run deploy analytics-mcp \ --source . \ --region us-central1 \ --allow-unauthenticated \ --max-instances 1 \ --set-env-vars "ANALYTICS_MCP_OAUTH=true,GOOGLE_OAUTH_CLIENT_ID=YOUR_CLIENT_ID.apps.googleusercontent.com" \ --set-secrets "GOOGLE_OAUTH_CLIENT_SECRET=analytics-mcp-oauth-secret:latest" # 3. Set ANALYTICS_MCP_ISSUER_URL to the deployed Cloud Run URL and add # <SERVICE_URL>/oauth/callback to Authorized redirect URIs in Cloud Console SERVICE_URL=$(gcloud run services describe analytics-mcp --region us-central1 --format="value(status.url)") gcloud run services update analytics-mcp \ --region us-central1 \ --update-env-vars "ANALYTICS_MCP_ISSUER_URL=${SERVICE_URL}"Local Docker:
docker build -t analytics-mcp . docker run --rm -p 8080:8080 \ -e ANALYTICS_MCP_OAUTH=true \ -e GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com" \ -e GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret" \ analytics-mcp
See the complete multi-tenant walkthrough and runnable ADK agent code in
examples/multi_tenant_adk_agent/README.md.
Try it out π₯Ό
Launch Gemini Code Assist or Gemini CLI and type /mcp. You should see
analytics-mcp listed in the results.
Here are some sample prompts to get you started:
Ask what the server can do:
what can the analytics-mcp server do?Ask about a Google Analytics property
Give me details about my Google Analytics property with 'xyz' in the namePrompt for analysis:
what are the most popular events in my Google Analytics property in the last 180 days?Ask about signed-in users:
were most of my users in the last 6 months logged in?Ask about property configuration:
what are the custom dimensions and custom metrics in my property?Create a custom dimension (requires the
--allow-writeflag):Create an event-scoped custom dimension for the plan_tier parameter in property 12345
Contributing β¨
Contributions welcome! See the Contributing Guide.
Troubleshooting
See the Troubleshooting Guide for common issues and workarounds.
Advanced reporting
Phase 1 adds read-only metadata, compatibility, pivot, batch and period-comparison tools. See Advanced reporting for schemas, examples, validation rules and structured output details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Google Search Console and Google Analytics for AI agents.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
Connect Google Analytics to ChatGPT. Query GA4 data in plain English and get instant insights.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables LLMs to interact with Google Analytics Admin and Data APIs to retrieve account summaries, property details, and custom metrics. It allows users to run core and real-time reports to analyze website performance and configuration via natural language.71Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables LLMs to interact with Google Analytics 4 data through the Google Analytics Data API, supporting standard reports, real-time data, and metadata retrieval.19MIT
- AlicenseAqualityDmaintenanceEnables LLMs to interact with Google Analytics via Admin and Data APIs, allowing users to retrieve account summaries, run reports, and analyze realtime data.6Apache 2.0
- AlicenseBqualityDmaintenanceEnables managing Google Analytics 4 properties, data streams, conversions, and running reports using natural language through the Admin and Data APIs.2338 PyPIMIT