Google Analytics MCP server: what it is and what it can read
Google publishes an MCP server for Google Analytics. Its guide says the server “lets you connect your Google Analytics data to large language models (LLMs) and AI agents, such as Gemini”.[1] It is Google’s server, not Convertlyft’s. This page sums up Google’s guide: what the server reads, what you need to run it, and where it stops.
Start free. No card needed. Plans and limits are on the pricing page.
What Google’s server is
Google’s guide says you can use the server “to query reports in natural language, inspect property configurations, and build custom analytics agents”.[1]
It only reads. Google’s note: “The MCP server is available for read requests only. It can't create, modify, or delete your Google Analytics configuration or settings.”[1]
The nine tools it gives your AI
Google lists nine read-only tools. Four find your accounts and properties, and five run reports or read what a property defines.[1]
| Tool | What it does |
|---|---|
get_account_summaries | Lists the Google Analytics accounts and properties you can reach.[1] |
get_property_details | Returns the configuration details of one property.[1] |
list_google_ads_links | Lists a property’s links to Google Ads accounts.[1] |
list_property_annotations | Lists the annotations set on a property.[1] |
get_custom_dimensions_and_metrics | Reads the custom dimensions and custom metrics defined for a property.[1] |
run_report | Runs a standard Google Analytics report.[1] |
run_realtime_report | Runs a realtime report.[1] |
run_funnel_report | Runs a funnel exploration report.[1] |
run_conversions_report | Runs a report on how key actions perform (Google’s word for them: conversions).[1] |
What you need before you connect
- Python 3.10 or higher, and pipx or uv to run the server.[1]
- A Google Cloud project with the Google Analytics Admin API and the Google Analytics Data API enabled.[1]
- At least the Viewer role on the Google Analytics property, for your own account or for a service account.[1]
- Google credentials that carry the read-only Analytics scope.[1]
How it connects
The server runs on your own computer: your AI app starts it with pipx or uvx. It is published on PyPI as analytics-mcp.[1]
Google’s guide gives the configuration for Antigravity CLI and Antigravity IDE, Claude Desktop, Claude Code and Cursor, and notes that Gemini CLI is deprecated.[1]
Copy the configuration from the guide itself, so that it is the current one.
What you can ask it
Three of the sample prompts in Google’s guide:[1]
- “How many users did I have yesterday?”
- “What were my top selling products yesterday?”
- “What custom dimensions and custom metrics are configured in my property?”
When it does not start
Google’s troubleshooting list, in short:[1]
- 403 PERMISSION_DENIED. Both APIs must be enabled in the project, and the account needs at least the Viewer role on the property.
- 401 UNAUTHENTICATED, or the credentials file is not found. Give the full path to the credentials file, and sign in again if your credentials have expired.
- The server fails to launch. Check that Python 3.10 or higher is installed. Desktop apps often do not inherit your shell’s PATH, so give the full path to pipx or uvx.
Google’s server and Convertlyft’s
Convertlyft has an MCP server of its own, for a different set of numbers: it answers from what the Convertlyft tag records on your site, the rank checks it runs, and the Search Console property you connect. Any MCP client can read your site's numbers, visits, errors and SEO.
To connect it, paste one address into Claude, ChatGPT, Cursor or VS Code and get answers about your visits, errors and SEO. The steps for each app are on the developers page, and Search Console in your AI tools covers the Search Console part.
Questions
Is there an official Google Analytics MCP server?
Yes. Google publishes one and documents it on Google for Developers. It is for read requests only.[1]
Can the Google Analytics MCP server change my settings?
No. Google’s guide says it “can't create, modify, or delete your Google Analytics configuration or settings”.[1]
Does the Google Analytics MCP server work with Claude?
Google’s guide gives the configuration for Claude Desktop and Claude Code, and for Cursor and Antigravity.[1]
Is this Convertlyft’s MCP server?
No. It is Google’s. Convertlyft has its own, for what Convertlyft records on your site; the developers page has the steps.
Sources
- Google for Developers, “Try the Google Analytics MCP server”, last updated 10 November 2026, developers.google.com/analytics/devguides/MCP, checked 12 November 2026.
Start on Pro, free for 14 days
Your new account gets 10,000 visits a month, no card needed. After 14 days it moves to Free, up to 5,000 visits a month with every feature, unless you choose Pro.