{"_id":"@bossforce.ai/mcp-google-analytics","name":"@bossforce.ai/mcp-google-analytics","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bossforce.ai/mcp-google-analytics","version":"0.1.0","type":"module","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/analytics/google-analytics"},"publishConfig":{"access":"public"},"bin":{"bossforce-mcp-google-analytics":"dist/bin.js"},"dependencies":{"zod":"^4.4.3","@bossforce.ai/mcp-google":"0.1.0","@bossforce.ai/mcp-core":"0.3.0"},"devDependencies":{"@bossforce.ai/mcp-testkit":"0.0.0"},"scripts":{"build":"tsc -p tsconfig.json","test":"node --test \"dist/*.test.js\""},"_id":"@bossforce.ai/mcp-google-analytics@0.1.0","description":"MCP server for **Google Analytics 4** (Data API v1beta). Run reports on traffic, users and events, fetch realtime activity, and list available metrics and dimensions. Read-only.","bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","_integrity":"sha512-7N2cOwuyDEjxLCzF7o/9sv5ZicCq7jknrzjLL8NDYKOmflLyeRHSxkLGz3X/2N4tR3ZVusHvmnYCKvRykpMBZA==","_resolved":"C:\\Users\\user\\AppData\\Local\\Temp\\fdfa91c19b2ee57b28da7871e6d590d9\\bossforce.ai-mcp-google-analytics-0.1.0.tgz","_from":"file:bossforce.ai-mcp-google-analytics-0.1.0.tgz","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-7N2cOwuyDEjxLCzF7o/9sv5ZicCq7jknrzjLL8NDYKOmflLyeRHSxkLGz3X/2N4tR3ZVusHvmnYCKvRykpMBZA==","shasum":"683c94c28ce776d30aaf6e3ab5e8cf59b907287e","tarball":"https://registry.npmjs.org/@bossforce.ai/mcp-google-analytics/-/mcp-google-analytics-0.1.0.tgz","fileCount":22,"unpackedSize":15530,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDrevsL5xKdSfrsDy4D7YyJIboro9QC4ShxgkO8mhn8dAiEA6Ggr5AGTbnm0Q1TOmLAQEOjNn3Qv9n1CrfPrF5wp/FY="}]},"_npmUser":{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"},"directories":{},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-google-analytics_0.1.0_1781069218399_0.5327022515820155"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-10T05:26:58.220Z","0.1.0":"2026-06-10T05:26:58.545Z","modified":"2026-06-10T05:26:58.778Z"},"maintainers":[{"name":"bossforce.ai","email":"bossforce.ai@gmail.com"}],"description":"MCP server for **Google Analytics 4** (Data API v1beta). Run reports on traffic, users and events, fetch realtime activity, and list available metrics and dimensions. Read-only.","homepage":"https://github.com/bossforce-ai/bossforce-tools#readme","repository":{"type":"git","url":"git+https://github.com/bossforce-ai/bossforce-tools.git","directory":"mcps/analytics/google-analytics"},"bugs":{"url":"https://github.com/bossforce-ai/bossforce-tools/issues"},"readme":"# @bossforce.ai/mcp-google-analytics\n\nMCP server for **Google Analytics 4** (Data API v1beta). Run reports on traffic,\nusers and events, fetch realtime activity, and list available metrics and\ndimensions. Read-only.\n\n## Auth (OAuth2)\n\nThe platform performs the Google authorization and injects these env vars; the\nserver exchanges the refresh token for short-lived access tokens itself (cached,\nrefreshed a minute before expiry).\n\n| Env                              | Source                          |\n| -------------------------------- | ------------------------------- |\n| `GOOGLE_ANALYTICS_CLIENT_ID`     | OAuth client id (server `.env`) |\n| `GOOGLE_ANALYTICS_CLIENT_SECRET` | OAuth client secret             |\n| `GOOGLE_ANALYTICS_REFRESH_TOKEN` | per-workspace, from OAuth flow  |\n\nCredentials are read lazily, so the server boots and answers `tools/list`\nwithout them.\n\nScope: `analytics.readonly`.\n\n## Tools\n\n| Tool                  | Arguments                                                                   | Purpose                           |\n| --------------------- | --------------------------------------------------------------------------- | --------------------------------- |\n| `run_report`          | `property_id`, `start_date`, `end_date`, `metrics`, `dimensions?`, `limit?` | report over a date range          |\n| `run_realtime_report` | `property_id`, `metrics`, `dimensions?`, `limit?`                           | realtime activity (last ~30 min)  |\n| `get_metadata`        | `property_id`                                                               | list available metrics/dimensions |\n\n`property_id` is the numeric GA4 property id (e.g. `123456789`), not a Universal\nAnalytics view id. Dates accept `YYYY-MM-DD` or relative values such as\n`7daysAgo` and `today`.\n\n## Develop\n\n```bash\npnpm --filter @bossforce.ai/mcp-google-analytics build\npnpm --filter @bossforce.ai/mcp-google-analytics test\nUPDATE_SNAPSHOTS=1 pnpm --filter @bossforce.ai/mcp-google-analytics test  # after a signature change\n```\n","readmeFilename":"README.md","_rev":"1-6a8ea916f54ce72c02bf12fbc85dd713"}