Google Meet

google_meet

When to use

The user says any of:

• "join my Meet at "
• "take notes on this meeting"
• "summarize the meeting and send followups"
• "sit in on my standup"
• "be a bot in this call and speak up when X"

Two modes

Pick realtime only when the user actually wants the agent to speak. It costs real money (OpenAI Realtime is pay-per-audio-minute) and requires a virtual audio device set up on the machine running the bot.

Two locations

Prerequisites the user must handle once

Easiest path — run the built-in installer:

sonic plugins enable google_meet
sonic meet install                 # pip deps + Chromium (transcribe only)
sonic meet install --realtime      # + pulseaudio-utils / brew blackhole+ffmpeg
sonic meet auth                    # optional; skips guest-lobby wait
sonic meet setup                   # preflight checks

sonic meet install --realtime prompts before running sudo apt-get (Linux) or brew install (macOS). Pass --yes to skip the prompt. It will NOT touch your macOS default-input setting — you have to select BlackHole 2ch in System Settings yourself before starting a realtime meeting.

Or do it manually:

pip install playwright websockets && python -m playwright install chromium

# For realtime mode, additionally:
#   Linux:  sudo apt install pulseaudio-utils
#   macOS:  brew install blackhole-2ch ffmpeg
#           → System Settings → Sound → Input → BlackHole 2ch
#   Then set OPENAI_API_KEY or SONIC_MEET_REALTIME_KEY in ~/.sonic/.env

For a remote node:

# on the user's Mac (where Chrome is signed in):
pip install playwright websockets && python -m playwright install chromium
sonic plugins enable google_meet
sonic meet node run --display-name my-mac    # persistent server
# copy the printed token

# on the gateway:
sonic meet node approve my-mac ws://<mac-ip>:18789 <token>
sonic meet node ping my-mac                   # confirm reachable

Run sonic meet setup to preflight local prereqs.

Flow

1. Join — call meet_join(url=..., mode=..., node=...). Returns immediately.
2. Announce yourself — no auto-consent. Say (in whatever channel the user is watching): "A Sonic agent bot is in this call taking notes."
3. Poll — meet_status() for liveness, meet_transcript(last=20) for recent captions. Don't re-read the whole transcript every turn.
4. Speak (realtime only) — meet_say(text="...") queues text for TTS. The speech lags by ~2s. Don't spam it.
5. Leave — meet_leave() when done, or set duration="30m" on meet_join for auto-leave.
6. Follow up — read meet_transcript() in full, summarize, and use regular tools to send the recap, file issues, schedule followups.

Tool reference

node? on all tools: pass a registered node name (or "auto" for the sole node) to operate a remote bot instead of a local one. Omit for local.

Important limits

• Captions are only as good as Google Meet's live captions. English-biased, lossy on overlapping speakers.
• Guest mode sits in the lobby until a host admits. Warn the user; sonic meet auth avoids this.
• Lobby timeout: if the host doesn't admit the bot within 5 minutes (configurable via SONIC_MEET_LOBBY_TIMEOUT env), the bot leaves and meet_status reports leaveReason: "lobby_timeout".
• One active meeting per install per location. A second meet_join leaves the first.
• Windows not supported.
• Realtime mode needs a virtual audio device. If the audio bridge setup fails, the bot falls back to transcribe mode and flags it in meet_status().error.
• meet_say requires mode='realtime' on the originating meet_join. Calling it against a transcribe-mode meeting returns a clear error.
• Barge-in is best-effort. When a caption arrives attributed to a real participant while the bot is generating audio, the bot sends response.cancel to OpenAI Realtime. Captions take ~500ms to show up, so the bot will talk over the first second or so of a human interruption.

Status dict reference

meet_status() returns (subset shown, there are more):

Transcript location

Local:

$SONIC_HOME/workspace/meetings/<meeting-id>/transcript.txt

Remote node: transcript lives on the node host's disk. Use meet_transcript(node=...) to read it over RPC.

Safety

• URL regex: only https://meet.google.com/... URLs pass.
• No calendar scanning. No auto-dial.
• Remote nodes use bearer-token auth; tokens are generated on the node (32 hex chars, persisted in $SONIC_HOME/workspace/meetings/node_token.json) and must be copied to the gateway via sonic meet node approve.
• meet_say text is rate-limited by the OpenAI Realtime session; spam-protection is the bot's problem, not yours, but still — don't queue hundreds of lines.