Google Chat
Overview
Use this skill to read Google Chat messages from specific spaces or threads using local OAuth credentials.
Quick start
- Create/refresh the Chat OAuth token:
bashpython scripts/chat_auth.py
- Fetch messages from a space:
bashpython scripts/chat_fetch.py \ --space AAAAAAA... \ --limit 50
- Fetch messages from a Gmail Chat URL (auto-extracts space/thread):
bashpython scripts/chat_fetch.py \ --space "https://mail.google.com/chat/u/0/#chat/space/..." \ --limit 50
Common tasks
Authenticate or refresh token
- Run
scripts/chat_auth.py. - If browser login is blocked, pass
--no-browserto use the console flow. - Token is stored at
~/.config/google-chat/token.jsonby default.
List spaces
bashpython scripts/chat_list_spaces.py
Fetch messages from a thread
bashpython scripts/chat_fetch.py \ --space AAAAAAA... \ --thread THREAD_ID \ --limit 50
Output formats
- Default output is
text(timestamp | sender | text | message name). - Use
--format jsonto get a JSON payload withmessagesandnextPageToken.
Notes
- If a Chat URL is provided, extract the space/thread IDs and use them directly.
- Keep output scoped to what the user asked for; avoid dumping full histories by default.
- Default client secret path is
~/.config/skills/client_secret.json. If missing, pass--client-secretexplicitly (recommended to document the path inAGENTS.md).
References
references/setup.md

