A clean, intuitive analytics dashboard for the Google Analytics 4 data you already collect. One calm screen per site, click any row to filter, compare periods in a click, and see visitors live on a globe. It brings the modern interaction model that Rybbit introduced to GA4, so you get it without running an event database.
Every report comes from your GA4 properties through the GA4 Data and Admin APIs, using a read-only service account. Keep your existing GA4 tag: there is no new tracking script and no event storage of its own. Search Console and AdSense are optional extras on top.
What that saves you:
- No analytics server to pay for. Self-hosted Rybbit or Plausible run ClickHouse and PostgreSQL, which grow to hundreds of GB, then TBs, over the years. GA4 stores and queries events for free, with no event cap on standard properties. MetriBee is one small Fastify process that runs on your laptop, a Raspberry Pi or the cheapest VPS you already have.
- Small application database. SQLite stores accounts, organizations, access grants, funnels and widgets in one local file, with Drizzle schema management and automatic versioned migrations. Analytics events remain in GA4; back up the application database with
pnpm db:backup. - Depth without the weight. Lighter tools like Umami are easy to host but have fewer features, and their PostgreSQL row store slows down as years of events pile up. MetriBee gives you funnels, journeys, retention and a live globe on Google's warehouse.
- No migration. Years of GA4 history show up on day one. If you stop using MetriBee, your data is still in GA4.
What you get:
- Intuitive UI on your GA4 reports. Overview, Pages, Events, Journeys, Retention and Funnels in one shell, with click-to-filter, period comparison and keyboard shortcuts.
- Every GA4 property on one screen. Cards, Status, Table and Heatmap views across all properties the service account can see, with CSV export and optional AdSense earnings.
- Realtime with spike alerts. Live users from the GA4 Realtime API for every property, plus a live 3D globe.
- Saved analysis. Reusable segments, chart annotations, conversion goals and custom dashboards with native Rybbit controls and GA4 metrics.
- Reports to share. Native PDF exports and weekly email reports with account preferences and property access checks.
- Funnels, journeys, retention. GA4 funnel reports, page transitions and first-visit cohorts; optional BigQuery export adds real two-to-ten-step session journeys.
- Search Console built in. Clicks, impressions, CTR and position sit next to GA4 metrics in the same tables.
- Widgets and share links. Embeddable cards and badges from GA4 metrics, public dashboards and revocable private links.
- Accounts and collaboration. Better Auth with SQLite, organization invitations, five roles, teams, property access grants, account management and personal/organization API keys.
- MCP server at
/mcp. Claude Code, Codex, Cursor and others can query your GA4 and Search Console data. - Quota-safe. Report caches and per-property quota guards keep you inside GA4's free API limits.
- Privacy mode. Press P to blur names and URLs before screen sharing.
Docker is the easiest way to run MetriBee. Paste this prompt into Claude Code, Codex, Gemini CLI or any AI agent that can run commands. The agent installs MetriBee, creates the Google service account and connects your GA4 properties.
Install MetriBee (https://github.com/nexmoe/MetriBee) with Docker and connect it to my Google Analytics 4.
1. Check that Docker is installed and running. Clone the repo and cd into it.
2. Read SETUP.md and follow its "With an AI agent" prompt to create a Google Cloud service account
and fill GA4_CLIENT_EMAIL and GA4_PRIVATE_KEY in .env. Use its Docker notes for the checks.
3. Run: docker compose pull && docker compose up -d
Then run docker compose exec dashboard node scripts/setup-check.js until it passes.
4. Give me the URL from the ports line in docker-compose.yml.
5. Ask me if I also want the MCP server added to my AI tool. If yes, follow "Use with AI (MCP)" in SETUP.md.
Rules: never print the private key, never commit .env, and stop to ask me before any step that needs my
Google sign-in or GA4 admin access. Create the first administrator at /signup, configure BASE_URL for the deployment, and keep Google credentials in .env.
If Docker is not available, ask me before falling back to Node.js 22+ and pnpm (see "Install" in SETUP.md).
Want to set it up by hand, run it from source, or put it online behind Cloudflare Access or Tailscale? See SETUP.md. Every feature is documented in docs/features.md.
Self-hosted needs no payment credentials. Optional MetriBee Cloud uses Waffo Pancake for fixed organization subscriptions, hosted checkout, invoices and subscription management. See Cloud billing setup.
The workspace checks GitHub Releases once per browser tab session. A newer version shows a dismissible notice linking to that release for a manual upgrade. Unavailable checks are skipped silently.
Container images are built only for published releases. ghcr.io/nexmoe/metribee:latest follows the latest stable release; use a version tag such as :2.3.0 to pin a deployment. Ordinary commits and pull requests do not build or publish images.
All screenshots use demo mode (DEMO=1): generated data for 8 fictional sites, no Google account.
 |
 |
| Home: every property at a glance | Realtime: live users and spike alerts across all sites |
 |
 |
| Status: what needs a look today | Heatmap: sessions per site per day |
 |
 |
| Overview: GA4 reports in Rybbit's native cards | Pages: GA4 and Search Console in one table |
 |
 |
| Funnels: saved, ordered GA4 funnels | Journeys: where visitors go next |
 |
 |
| Retention: GA4 first-visit cohorts | Events: every GA4 event and key event |
 |
 |
| Widgets: embeddable cards and badges | Table: sortable, exportable per-site metrics |
| MetriBee | Rybbit (self-hosted) | Umami (self-hosted) | Plausible CE | |
|---|---|---|---|---|
| Hosting and cost | ||||
| Event storage on your server | ✅ none, Google stores it | ❌ ClickHouse, grows forever | ❌ PostgreSQL, grows forever | ❌ ClickHouse, grows forever |
| Services to run | 1 Node process | ClickHouse + Postgres + Redis + app | Postgres + app | ClickHouse + Postgres + app |
| Typical server | Smallest VPS / Pi | 2–4 GB RAM, 2 vCPU, 20–50 GB+ disk | 1–2 GB RAM | 2+ GB RAM |
| Free with unlimited events | ✅ | ✅ (you pay for the server) | ✅ (you pay for the server) | ✅ (you pay for the server) |
| Columnar engine for years of data | ✅ GA4 / BigQuery-class backend | ✅ ClickHouse | ✅ ClickHouse | |
| Keep existing GA4 tag, no migration | ✅ | ❌ new script | ❌ new script | ❌ new script |
| Dashboards | ||||
| Multi-site home (cards, status, table, heatmap) | ✅ | |||
| Realtime overview across all sites | ✅ | |||
| Traffic spike detection and alerts | ✅ | ❌ | ❌ | ❌ |
| Live 3D globe | ✅ | ✅ | ❌ | ❌ |
| Funnels | ✅ | ✅ | ✅ | ✅ |
| User journeys (Sankey) | ✅ | ✅ | ✅ | ✅ |
| Retention cohorts | ✅ | ✅ | ✅ | ❌ |
| Search Console in the same tables | ✅ | ✅ | ❌ | ✅ |
| Embeddable widgets and badges | ✅ | ❌ | ❌ | |
| Public or private share links | ✅ | ✅ | ✅ | ✅ |
| AdSense earnings per site | ✅ | ❌ | ❌ | ❌ |
| API quota monitor | ✅ | – | – | – |
| MCP server for AI assistants | ✅ built in | ✅ | ✅ | ❌ |
| Privacy mode for screen sharing | ✅ | ❌ | ❌ | ❌ |
| Where the others win | ||||
| Session replay | ❌ | ✅ | ✅ | ❌ |
| Web Vitals and error tracking | ❌ | ✅ | ❌ | |
| You own every raw event | ❌ | ✅ | ✅ | ✅ |
| Cookieless, no consent banner | ❌ GA4 rules apply | ✅ | ✅ | ✅ |
✅ yes ·
pnpm test # run the unit test suite (mocha)
pnpm build # TypeScript compilation checkOpen an issue first and wait for the approved label, then send one pull request per feature or fix. Full rules: CONTRIBUTING.md.
MetriBee is licensed under AGPL-3.0. It includes MIT-licensed code from GA4-Dashboard-MCP (license) and AGPL-3.0 code from Rybbit (notices). See NOTICE for details.
- Rybbit by the Rybbit team. MetriBee's whole UI is Rybbit's React frontend, adapted to GA4 under AGPL-3.0. I really like Rybbit and ran it as my own analytics for a long time before building this. If you want tracking that is entirely your own (first-party script, every raw event on your servers, cookieless, session replay, web vitals and error tracking), use Rybbit. It's excellent, and you can self-host it or use Rybbit Cloud. MetriBee is for people who already have GA4 and want Rybbit's experience without running the storage.
- GA4-Dashboard-MCP by Amit Yadav (@TheTechBasket). MetriBee started as a fork of it. Its GA4 backend, quota handling, caching and MCP server are the foundation everything here is built on, and it remains MIT-licensed.