ga4-mcp

GA4 + Google Search Console MCP server. Works with Claude, Copilot, Cursor, Codex, Gemini, and any MCP-compatible AI agent.

16 tools for Google Analytics 4, Search Console, and the Indexing API — run reports, inspect URLs, submit sitemaps, manage properties, and request indexing, all from your AI agent.

Quick Start

npx -y ga4-mcp

Or install globally for faster startup:

npm install -g ga4-mcp
ga4-mcp

Prerequisites

Authenticate with Google (includes all required scopes):

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/analytics.edit,https://www.googleapis.com/auth/webmasters,https://www.googleapis.com/auth/indexing"

Or set GOOGLE_APPLICATION_CREDENTIALS to a service account JSON key file.

Agent Configuration

Claude Code

{
  "mcpServers": {
    "ga4-analytics": {
      "command": "npx",
      "args": ["-y", "ga4-mcp"]
    }
  }
}

Cursor / Windsurf / Continue

Add to .cursor/mcp.json or equivalent:

{
  "mcpServers": {
    "ga4-analytics": {
      "command": "npx",
      "args": ["-y", "ga4-mcp"]
    }
  }
}

Load only specific tool groups

{
  "mcpServers": {
    "ga4-analytics": {
      "command": "npx",
      "args": ["-y", "ga4-mcp", "--tools", "ga4,gsc"]
    }
  }
}

CLI Options

ga4-mcp [options]

--tools <groups>     Tool groups to enable: ga4, gsc, indexing, admin, all (default: all)
                     "ga4" = read-only analytics. "admin" = write/delete mega-tool.
--transport <type>   Transport: stdio (default) or http (Streamable HTTP)
--port <number>      HTTP port (default: 3000)
--version            Show version
--help               Show help

Environment variables: GA4_MCP_TOOLS, GA4_MCP_TRANSPORT, GA4_MCP_PORT

Tools (16 total)

Utility (1 tool)

| Tool | Description | |------|-------------| | ping | Health check — returns pong (always registered) |

GA4 Analytics (6 tools) — group: ga4

| Tool | Description | |------|-------------| | get_account_summaries | List all GA4 accounts and properties | | get_property_details | Property details (name, timezone, currency) | | run_report | Run GA4 Data API reports | | run_realtime_report | Run GA4 realtime reports | | get_custom_dimensions_and_metrics | Custom dimensions and metrics | | list_google_ads_links | Google Ads links for a property |

GA4 Admin (1 mega-tool, 14 actions) — group: admin

| Tool | Description | |------|-------------| | ga4_admin | Create/update/delete properties, streams, key events, audiences |

Google Search Console (6 tools) — group: gsc

| Tool | Description | |------|-------------| | gsc_list_sites | List all GSC properties | | gsc_search_analytics | Query search analytics (impressions, clicks, CTR, position) | | gsc_inspect_url | URL inspection (index status, crawl info, mobile usability) | | gsc_list_sitemaps | List submitted sitemaps | | gsc_add_site | Add a site to GSC | | gsc_submit_sitemap | Submit a sitemap |

Indexing API (2 tools) — group: indexing

| Tool | Description | |------|-------------| | indexing_notify | Notify Google to crawl/remove a URL | | indexing_status | Check notification status for a URL |

License

MIT