google-chat

# Google Chat Lightweight Google Chat integration with standalone OAuth authentication. No MCP server required. > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported. Everything is sent as the authenticated user, so treat write commands as outward-facing: confirm the exact text with the user before posting to a space, and never send to a channel the user did not name. ## First-Time Setup ```bash pip install -r requirements.txt python scripts/auth.py login # opens browser python scripts/auth.py status # verify python scripts/auth.py logout ``` ## Commands All operations via `scripts/chat.py`. Auto-authenticates on first use if not logged in. ### Reading ```bash python scripts/chat.py get-messages spaces/AAAA123 --limit 10 python scripts/chat.py get-messages spaces/AAAA123 --limit 10 --raw # full JSON python scripts/chat.py get-message spaces/AAAA123/messages/XYZ python scripts/chat.py list-threads spaces/AAAA123 python scripts/chat.py list-spaces python scripts/chat.py find-space "Project Alpha" # ignores punctuation/spacing python scripts/chat.py list-members spaces/AAAA123 ``` Read output is compact by default — one block per message with its timestamp, sender, text and resource name. That is roughly 14x smaller than the raw API payload, which matters when an agent is paying for every token it reads. Use `--raw` when you need the full JSON. ### Writing ```bash python scripts/chat.py send-message spaces/AAAA123 "Hello te...