TOOLKIT

Google Analytics MCP

Google’s own MCP server for GA4: seven read-only tools over the Admin and Data APIs, so an agent can run reports on your property without a CSV export.

by Google (official)googleanalytics/google-analytics-mcpApache-2.0 licence3.2k starscommit a8ca729

Marked experimental by Google and published on PyPI as `analytics-mcp`. Seven tools: account summaries, property details, Google Ads links, a core report runner, a funnel report runner, custom dimensions and metrics, and a realtime report.

Read-only by construction: the credentials must carry the `analytics.readonly` scope and nothing else. There is no tool that writes to a property.

The setup is the cost: a Google Cloud project with the Admin and Data APIs enabled, Application Default Credentials for a user with access to the property (or a service account you impersonate), and pipx to run the server.

Connects to: Google Analytics 4 (Admin API + Data API)
Access: read-only (analytics.readonly scope)
Tools: 7, all read

Connect

claude mcp add analytics-mcp --scope user \
  -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" \
  -e "GOOGLE_PROJECT_ID=YOUR_PROJECT_ID" \
  -- pipx run analytics-mcp

Run this in a terminal inside your project folder. Claude Code, Cursor and Codex then read the skill from where it lands.

Requires

a Google Cloud project with the GA4 Admin and Data APIs enabled
Application Default Credentials: OAuth desktop client or service-account impersonation
pipx (Python 3.10+)

Safety review of the skill text and its scripts
Network	yes	Calls Google’s Analytics APIs with your credentials; nothing else.
Shell	no	Runs as a local process under pipx; exposes no shell tool.
Secrets	yes	Reads the credentials file you point it at. Keep it out of the repository.
Deletes	no	No write or delete tool exists in the server.

What it exposes

7 tools, and which ones change things

All tools: get_account_summaries get_property_details list_google_ads_links run_report run_funnel_report get_custom_dimensions_and_metrics run_realtime_report

Writes

None. There is no tool in this server that changes your data.

Pairs with

Skills that work on what it reads

How to install these skills: three routes into Claude Code, and one line to check they loaded.

Method behind it

Once the server runs, the questions worth asking it are the ones our ROAS glossary sets up: revenue per channel over a fixed window, compared with what the ad platform claims for the same window.

What is ROAS

Questions

Questions people ask before installing

Can it change anything in my GA4 property?

No. The scope is read-only and the tool list has no write. The worst a bad prompt can do is run an expensive report.

Does it work with Claude Code as well as Gemini?

Yes. The README documents both: a settings.json entry for Gemini and a `claude mcp add` line for Claude Code, with the same two environment variables.

Whose data does it see?

Whatever the credentialed user or service account can see in GA4. Use a user with access to only the properties you want the agent to read.