{"_id":"ga4-mcp","_rev":"2-c098325a85c305dfe71130bcd8fdd1e6","name":"ga4-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"ga4-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","google-analytics","ga4","google-search-console","gsc","seo","indexing-api","claude","copilot","cursor","codex","gemini","ai","stdio"],"author":{"url":"https://chimpmatic.com","name":"chimpmatic"},"license":"MIT","_id":"ga4-mcp@1.0.0","maintainers":[{"name":"chimpmatic","email":"hello@chimpmatic.com"}],"homepage":"https://chimpmatic.com","bugs":{"url":"https://github.com/chimpmatic/ga4-mcp/issues"},"bin":{"ga4-mcp":"dist/server.js"},"dist":{"shasum":"d6353cf54bf5ee931b6a5179056d77f3926370b5","tarball":"https://registry.npmjs.org/ga4-mcp/-/ga4-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-iK4anBV4G0B+itLI+QQ91xA8R/nL/CuQtiUdlzH42+8CcZeUqpa1HjjcRkOMBdPhJ32uq7eKYMAf4TPp9W74jg==","signatures":[{"sig":"MEUCIC4HkB6/dRg2JY0cI1FIa8pJ1y31SMX33fyBbUcycxqJAiEAu9vtWdbd14MAJSWRKLXNThlX9ej1yfSvPyO4Mpdao9M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28798},"type":"module","engines":{"node":">=18"},"gitHead":"938562f7e5a8418b34c79be2cec8d81f135bd73e","scripts":{"build":"node esbuild.config.mjs","typecheck":"tsc --noEmit","build:prod":"NODE_ENV=production node esbuild.config.mjs","prepublishOnly":"npm run build:prod"},"_npmUser":{"name":"chimpmatic","email":"hello@chimpmatic.com"},"repository":{"url":"git+https://github.com/chimpmatic/ga4-mcp.git","type":"git"},"_npmVersion":"11.7.0","description":"GA4 + Google Search Console MCP server for Claude, Copilot, Cursor, Codex, Gemini, and any MCP-compatible AI agent.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.25.0","google-auth-library":"^10.6.2","@google-analytics/data":"^5.2.1","@google-analytics/admin":"^9.0.1","@googleapis/searchconsole":"^6.0.1","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.25.0","typescript":"^5.7.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/ga4-mcp_1.0.0_1773973565483_0.8826233976668776","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"ga4-mcp","version":"1.0.1","description":"GA4 + Google Search Console MCP server for Claude, Copilot, Cursor, Codex, Gemini, and any MCP-compatible AI agent.","type":"module","bin":{"ga4-mcp":"dist/server.js"},"scripts":{"build":"node esbuild.config.mjs","build:prod":"NODE_ENV=production node esbuild.config.mjs","typecheck":"tsc --noEmit","prepublishOnly":"npm run build:prod"},"keywords":["mcp","model-context-protocol","google-analytics","ga4","google-search-console","gsc","seo","indexing-api","claude","copilot","cursor","codex","gemini","ai","stdio"],"author":{"name":"chimpmatic","url":"https://chimpmatic.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/chimpmatic/ga4-mcp.git"},"homepage":"https://chimpmatic.com","bugs":{"url":"https://github.com/chimpmatic/ga4-mcp/issues"},"engines":{"node":">=18"},"dependencies":{"@google-analytics/admin":"^9.0.1","@google-analytics/data":"^5.2.1","@googleapis/searchconsole":"^6.0.1","@modelcontextprotocol/sdk":"^1.27.1","google-auth-library":"^10.6.2","zod":"^3.25.0"},"devDependencies":{"@types/node":"^20.0.0","esbuild":"^0.25.0","typescript":"^5.7.0"},"gitHead":"2ea4560fa9af9d4ab41c8a0462014183bad39279","_id":"ga4-mcp@1.0.1","_nodeVersion":"25.3.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-iLMxHzlH65FkhfO//D22ePwEYUXWwBhL6vbHF8CCJ73Bl8O6L6jdZ89VZi8iPAu6M0zf3BcOI4cmolKYpEXC+A==","shasum":"6128b7eb3ed919028cf00e71504342ba430fc4ae","tarball":"https://registry.npmjs.org/ga4-mcp/-/ga4-mcp-1.0.1.tgz","fileCount":4,"unpackedSize":29260,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDUObhnT+sfiiXIUZJvfw64xJSwpj6gezV1or2LzWVQEAiAtyjwxlyQgvcZSMxNhMNb8006kqDiCJ1r6zcQYHgMoqA=="}]},"_npmUser":{"name":"chimpmatic","email":"hello@chimpmatic.com"},"directories":{},"maintainers":[{"name":"chimpmatic","email":"hello@chimpmatic.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ga4-mcp_1.0.1_1773973717190_0.5322243526817605"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T02:26:05.351Z","modified":"2026-03-20T02:28:37.516Z","1.0.0":"2026-03-20T02:26:05.632Z","1.0.1":"2026-03-20T02:28:37.404Z"},"bugs":{"url":"https://github.com/chimpmatic/ga4-mcp/issues"},"author":{"name":"chimpmatic","url":"https://chimpmatic.com"},"license":"MIT","homepage":"https://chimpmatic.com","keywords":["mcp","model-context-protocol","google-analytics","ga4","google-search-console","gsc","seo","indexing-api","claude","copilot","cursor","codex","gemini","ai","stdio"],"repository":{"type":"git","url":"git+https://github.com/chimpmatic/ga4-mcp.git"},"description":"GA4 + Google Search Console MCP server for Claude, Copilot, Cursor, Codex, Gemini, and any MCP-compatible AI agent.","maintainers":[{"name":"chimpmatic","email":"hello@chimpmatic.com"}],"readme":"# ga4-mcp\n\n[![npm version](https://img.shields.io/npm/v/ga4-mcp.svg)](https://www.npmjs.com/package/ga4-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/ga4-mcp.svg)](https://www.npmjs.com/package/ga4-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nGA4 + Google Search Console MCP server. Works with Claude, Copilot, Cursor, Codex, Gemini, and any MCP-compatible AI agent.\n\n16 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.\n\n## Quick Start\n\n```bash\nnpx -y ga4-mcp\n```\n\nOr install globally for faster startup:\n\n```bash\nnpm install -g ga4-mcp\nga4-mcp\n```\n\n### Prerequisites\n\nAuthenticate with Google (includes all required scopes):\n\n```bash\ngcloud auth application-default login \\\n  --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\"\n```\n\nOr set `GOOGLE_APPLICATION_CREDENTIALS` to a service account JSON key file.\n\n## Agent Configuration\n\n### Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"ga4-analytics\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ga4-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor / Windsurf / Continue\n\nAdd to `.cursor/mcp.json` or equivalent:\n\n```json\n{\n  \"mcpServers\": {\n    \"ga4-analytics\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ga4-mcp\"]\n    }\n  }\n}\n```\n\n### Load only specific tool groups\n\n```json\n{\n  \"mcpServers\": {\n    \"ga4-analytics\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ga4-mcp\", \"--tools\", \"ga4,gsc\"]\n    }\n  }\n}\n```\n\n## CLI Options\n\n```\nga4-mcp [options]\n\n--tools <groups>     Tool groups to enable: ga4, gsc, indexing, admin, all (default: all)\n                     \"ga4\" = read-only analytics. \"admin\" = write/delete mega-tool.\n--transport <type>   Transport: stdio (default) or http (Streamable HTTP)\n--port <number>      HTTP port (default: 3000)\n--version            Show version\n--help               Show help\n```\n\nEnvironment variables: `GA4_MCP_TOOLS`, `GA4_MCP_TRANSPORT`, `GA4_MCP_PORT`\n\n## Tools (16 total)\n\n### Utility (1 tool)\n| Tool | Description |\n|------|-------------|\n| `ping` | Health check — returns pong (always registered) |\n\n### GA4 Analytics (6 tools) — group: `ga4`\n| Tool | Description |\n|------|-------------|\n| `get_account_summaries` | List all GA4 accounts and properties |\n| `get_property_details` | Property details (name, timezone, currency) |\n| `run_report` | Run GA4 Data API reports |\n| `run_realtime_report` | Run GA4 realtime reports |\n| `get_custom_dimensions_and_metrics` | Custom dimensions and metrics |\n| `list_google_ads_links` | Google Ads links for a property |\n\n### GA4 Admin (1 mega-tool, 14 actions) — group: `admin`\n| Tool | Description |\n|------|-------------|\n| `ga4_admin` | Create/update/delete properties, streams, key events, audiences |\n\n### Google Search Console (6 tools) — group: `gsc`\n| Tool | Description |\n|------|-------------|\n| `gsc_list_sites` | List all GSC properties |\n| `gsc_search_analytics` | Query search analytics (impressions, clicks, CTR, position) |\n| `gsc_inspect_url` | URL inspection (index status, crawl info, mobile usability) |\n| `gsc_list_sitemaps` | List submitted sitemaps |\n| `gsc_add_site` | Add a site to GSC |\n| `gsc_submit_sitemap` | Submit a sitemap |\n\n### Indexing API (2 tools) — group: `indexing`\n| Tool | Description |\n|------|-------------|\n| `indexing_notify` | Notify Google to crawl/remove a URL |\n| `indexing_status` | Check notification status for a URL |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}