Skip to main content
Glama
chimpmatic

ga4-mcp

by chimpmatic
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

ga4-mcp

npm version npm downloads License: MIT

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chimpmatic/ga4-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server