Agent skill

google-chat

Read Google Chat spaces/threads via the Chat API, create/refresh OAuth tokens, parse Gmail Chat URLs, and list spaces. Use when asked to look up or verify messages in Google Chat or when you need API access to Chat from the CLI.

View SKILL.md on GitHub Repository
Stars 32
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/antoniolg/agent-kit/tree/main/skills/google-chat

SKILL.md

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:
bash
python scripts/chat_auth.py
  1. Fetch messages from a space:
bash
python scripts/chat_fetch.py \
  --space AAAAAAA... \
  --limit 50
  1. Fetch messages from a Gmail Chat URL (auto-extracts space/thread):
bash
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

bash
python scripts/chat_list_spaces.py

Fetch messages from a thread

bash
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

antoniolg/agent-kit

gen-pdf

Converts a Markdown file to a styled PDF with DevExpert branding (logo in bottom-right corner). Use when asked to generate a PDF from a Markdown document, or when any DevExpert proposal/document needs to be exported as PDF.

32 3
Explore
antoniolg/agent-kit

cloudflared-tunnel

Create temporary public URLs for localhost apps using Cloudflare Quick Tunnels with tmux-based process management. Use when you need to preview a local app externally (mobile device, remote collaborator, QA), including host-allowlist fixes when a dev server blocks external hosts.

32 3
Explore
antoniolg/agent-kit

email

Manage inbox email. Uses the inbox script and stores metadata (ids) to open or archive messages later.

32 3
Explore
antoniolg/agent-kit

whatsapp-evo

Manage WhatsApp via Evolution API (v2.x): list chats with unread messages and reply.

32 3
Explore
antoniolg/agent-kit

create-cli

Design command-line interface parameters and UX: arguments, flags, subcommands, help text, output formats, error messages, exit codes, prompts, config/env precedence, and safe/dry-run behavior. Use when you’re designing a CLI spec (before implementation) or refactoring an existing CLI’s surface area for consistency, composability, and discoverability.

32 3
Explore
antoniolg/agent-kit

academy-enrollments

Manage academy enrollments by appending rows to a Google Sheet (used by Zapier/n8n to grant LearnWorlds access).

32 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results