Google Chat Lightweight Google Chat integration with standalone OAuth authentication. No MCP server required. ⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported. First-Time Setup Authenticate with Google (opens browser): python scripts/auth.py login Check authentication status: python scripts/auth.py status Logout when needed: python scripts/auth.py logout Commands All operations via scripts/chat.py . Auto-authenticates on first use if not logged in.
List all spaces you're a member of
python scripts/chat.py list-spaces
Find a space by name
python scripts/chat.py find-space "Project Alpha"
Get messages from a space
python scripts/chat.py get-messages spaces/AAAA123 --limit 10
Send a message to a space
python scripts/chat.py send-message spaces/AAAA123 "Hello team!"
Send a message with file attachment
python scripts/chat.py send-message spaces/AAAA123 "Here's the report" --attachment /path/to/file.pdf
Send a direct message
python scripts/chat.py send-dm user@example.com "Hey, quick question..."
Send a DM with file attachment
python scripts/chat.py send-dm user@example.com "Please review" --attachment /path/to/file.pdf
Find or create DM space with someone
python scripts/chat.py find-dm user@example.com
List threads in a space
python scripts/chat.py list-threads spaces/AAAA123
Create a new space with members
- python scripts/chat.py setup-space
- "New Project"
- user1@example.com user2@example.com
- Space Name Format
- Google Chat uses
- spaces/AAAA123
- format. Get space names from
- list-spaces
- or
- find-space
- .
- Token Management
- Tokens stored securely using the system keyring:
- macOS
-
- Keychain
- Windows
-
- Windows Credential Locker
- Linux
- Secret Service API (GNOME Keyring, KDE Wallet, etc.) Service name: google-chat-skill-oauth Automatically refreshes expired tokens using Google's cloud function.