Skip to content
GA4 MCP
  • GitHub ↗
  • PyPI ↗
  • Install
GA4 MCP Server

Google Analytics 4 for AI agents.

Get started

  • Home
  • Setup
  • Install

Reference

  • Schema
  • IAM

Skills

  • All skills
  • AI Referral Analysis
  • Attribution Scope
  • Bot Traffic Detection
  • Channel Acquisition Analysis
  • Common Metric & Dimension Names
  • Compatible Dimension and Metric Combinations
  • Content Performance Analysis
  • Custom Dimensions and Event Parameters
  • Date Ranges
  • Ecommerce Analysis
  • Filter Structures
  • GA4 API Limitations
  • Geo and Device Segmentation
  • Traffic Change Diagnosis
  • UA to GA4 Field Name Mapping

Meta

  • GitHub ↗
  • PyPI ↗
  • npm ↗
  • Privacy
  • Terms

v2.11.4 · MIT

Terms of Service

Effective Date: September 17, 2026 • Software: GA4 MCP (Google Analytics Model Context Protocol Server) • Maintainer: Surendran Balachandran ([email protected]) • License: MIT License

By downloading, installing, running, or accessing the GA4 MCP server software, documentation, or the ephemeral OAuth authorization relay (collectively, the "Software" or "Service"), you agree to be bound by these Terms of Service ("Terms"). If you do not agree to these Terms, do not install or use the Service.

1. Open Source License (MIT)

GA4 MCP is an open-source software project licensed under the permissive terms of the MIT License:

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

2. Use of Google Analytics & Third-Party APIs

GA4 MCP acts as a local bridge between AI developer environments and Google Analytics APIs. Your use of Google APIs is independently governed by:

  • Google APIs Terms of Service
  • Google Analytics Terms of Service
  • Google API Services User Data Policy

You are solely responsible for ensuring that your reporting requests, automated queries, and data access comply with Google's quota limits, rate limits, and service terms.

3. Ephemeral OAuth Authorization Relay

For developer convenience, GA4 MCP operates an ephemeral Cloudflare Edge gateway to facilitate browser-based Google OAuth token exchange.

  • The authorization relay is provided free of charge for individual developers and organizations.
  • The relay acts strictly as a stateless pass-through; credentials and tokens are returned immediately to your local machine and never persisted in server databases.
  • You may bypass the authorization relay entirely at any time by configuring your own Google Cloud Service Account key (GOOGLE_APPLICATION_CREDENTIALS) or local Application Default Credentials (ADC).

4. Disclaimer of Warranties

THE SOFTWARE AND AUTHORIZATION RELAY ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

5. Limitation of Liability

Under no circumstances shall the maintainers, contributors, or affiliated entities be liable for any direct, indirect, incidental, consequential, special, or exemplary damages arising out of or in connection with your use or inability to use the Software, including but not limited to loss of data, loss of business profits, or API quota exhaustion.

6. Termination & Account Control

You may terminate your use of the Service at any time by removing the package from your MCP configuration, deleting local configuration files (rm -rf ~/.config/ga4-mcp), and revoking access in your Google Account Permissions Settings.

7. Contact Information

For questions regarding these Terms, please contact:

Surendran Balachandran
Maintainer, GA4 MCP
Email: [email protected]
GitHub: https://github.com/surendranb/google-analytics-mcp

GA4 MCP Server — Model Context Protocol server for Google Analytics 4. MIT licensed. Not affiliated with Google. "Google Analytics" is a trademark of Google LLC.

  • Setup
  • Filter schema
  • IAM
  • Skills
  • llms.txt
  • llms-full.txt
  • robots.txt
  • Sitemap
  • Privacy
  • Terms
  • GitHub
  • PyPI
  • npm

© 2026 Surendran Balachandran · GA4 MCP is open source under the MIT License.