Google Chat

Overview

Use this skill to read Google Chat messages from specific spaces or threads using local OAuth credentials.

Quick start

1. Create/refresh the Chat OAuth token:

python scripts/chat_auth.py

1. Fetch messages from a space:

python scripts/chat_fetch.py \
  --space AAAAAAA... \
  --limit 50

1. Fetch messages from a Gmail Chat URL (auto-extracts space/thread):

python 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-browser to use the console flow.
• Token is stored at ~/.config/google-chat/token.json by default.

List spaces

python scripts/chat_list_spaces.py

Fetch messages from a thread

python scripts/chat_fetch.py \
  --space AAAAAAA... \
  --thread THREAD_ID \
  --limit 50

Output formats

• Default output is text (timestamp | sender | text | message name).
• Use --format json to get a JSON payload with messages and nextPageToken.

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-secret explicitly (recommended to document the path in AGENTS.md).

References

• references/setup.md