Self-host

Get started with MeetBot

MeetBot is a service you run yourself — typically on a Mac mini that stays awake. Follow these steps once, then invite the bot to any Google Meet.

Open repository Pricing
  1. 1

    Install on macOS

    Clone the repo, install with pnpm, copy .env.example to .env, and build the web UI. Needs Node ≥ 22.13, Chrome in /Applications, and a logged-in GUI session.

  2. 2

    Create the bot Workspace user

    Create meetbot@your-domain with display name MeetBot. Sign in once, finish Workspace welcome, set language to English (US).

  3. 3

    Connect Calendar & Chrome

    Create a Desktop OAuth client for Calendar, run pnpm authorize-calendar (or Connect calendar in the UI). Then pnpm chrome-login and sign in as the bot.

  4. 4

    Optional: Jira + OpenRouter

    pnpm jira-login enables voice commands via Atlassian MCP. Set OPENROUTER_API_KEY for transcription and the agent.

  5. 5

    Web UI Google sign-in

    Create a Web OAuth client for PUBLIC_URL, set WEB_GOOGLE_CLIENT_ID/SECRET and WEB_SESSION_SECRET. Optional WEB_ALLOWED_DOMAIN.

  6. 6

    Run as a LaunchAgent

    Install the launchd plist, keep the Mac awake with auto-login, then invite the bot to any Meet. Health: GET /health.

Quick verify

pnpm selftest-audio
pnpm join-now https://meet.google.com/xxx-xxxx-xxx

Full setup, HTTPS / Let’s Encrypt, and troubleshooting live in the project README.