Agent skill

Google Chat

by sanjay3290 in sanjay3290/ai-skills

Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads, and manage spaces and DMs.

Apache-2.0Auto-check passedBackend & APIs

Install Google Chat

skills CLI
$ npx skills add sanjay3290/ai-skills --skill google-chat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sanjay3290/ai-skills google-chat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-chat .claude/skills/google-chat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-chat
GitHub stars
431
Token cost
~1.2k tokens
SKILL.md length
415 words
Files
7 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
Apache-2.0

At a glance

Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads, and manage spaces and DMs.

  • User asks to: send a message on Google Chat
  • SKILL.md covers First-Time Setup, Commands, Editing and deleting and Attachments, plus 3 more sections
  • Runs Python scripts from its folder; calls python and pip
  • Read chat messages

What it does

Google Chat is an agent skill from sanjay3290/ai-skills. Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads, and manage spaces and DMs. Use when user asks to: send a message on Google Chat, read chat messages, list chat spaces, find a chat room, send a DM, share a screenshot or file, edit or delete something already sent, or create a new space. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `README.md`, `directory.example.json` and `scripts/auth.py`).

It sits in Backend & APIs, covering Cloud office suites, Messaging and chat bots and OAuth and OpenID Connect. It works with Model Context Protocol, Google Workspace and React. The repository describes itself as: 24 cross-platform agent skills for Claude Code, Cursor, Codex & Gemini CLI — databases, messaging, research, TTS, DevOps, and Google Workspace. The licence is Apache-2.0.

When your agent uses it

  • User asks to: send a message on Google Chat
  • Read chat messages
  • List chat spaces
  • Find a chat room

Example prompts

  • “/google-chat”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 281d88d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Chat loads about 1.2k tokens when it runs. Until then it costs about 116 tokens; SKILL.md has 415 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~116
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from sanjay3290/ai-skills at commit 281d88d, republished under its Apache-2.0 licence (© sanjay3290). 415 words, ~1,248 tokens.

Download SKILL.mdSave it as .claude/skills/google-chat/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
google-chat
description
Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads, and manage spaces and DMs. Use when user asks to: send a message on Google Chat, read chat messages, list chat spaces, find a chat room, send a DM, share a screenshot or file, edit or delete something already sent, or create a new space. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.
license
Apache-2.0
metadata.author
sanjay3290
metadata.version
1.1

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 team!"
python scripts/chat.py send-dm user@example.com "Hey, quick question..."
python scripts/chat.py reply-in-thread spaces/AAAA123 spaces/AAAA123/threads/T "Following up."
python scripts/chat.py send-media spaces/AAAA123 "Latest mocks" --file a.png --file b.png
python scripts/chat.py edit-message spaces/AAAA123/messages/XYZ "Corrected text."
python scripts/chat.py delete-message spaces/AAAA123/messages/XYZ
python scripts/chat.py delete-message spaces/AAAA123/messages/XYZ --force   # has thread replies
python scripts/chat.py add-reaction spaces/AAAA123/messages/XYZ 👍
python scripts/chat.py setup-space "New Project" user1@example.com user2@example.com
python scripts/chat.py find-dm user@example.com

Add --dry-run to any write command to print the request instead of sending it. Use it when wiring up or testing a flow so nothing lands in a real channel. (For send-dm it reports the resolved recipient rather than the DM space, since resolving that needs a live call.)

Editing and deleting

send-message, send-dm and send-media return the created message's name (spaces/X/messages/Y) — that is what edit-message, delete-message and add-reaction take. You can only edit or delete messages you sent. To fix an older message, find its name with get-messages first.

Attachments

send-media takes a repeatable --file. Google Chat accepts several attachments on one message only when every attachment is media (image or video); a mixed batch is split automatically into one message per file, with the caption on the first. --attachment is still accepted as an alias for a single --file.

Show full SKILL.md (149 more words)Show less

Optional aliases

Typing full email addresses and spaces/AAAA... IDs is tedious, and having an agent call list-spaces to find a channel it uses daily is slow. Copy directory.example.json to directory.json and map short names:

json
{
  "users":  { "alex": "alex@example.com" },
  "spaces": { "team": { "id": "spaces/AAAAxxxxxxx", "name": "My Team" } }
}

Then send-message team "Deploying now" and send-dm alex "..." both resolve locally, with no API call. Full emails and spaces/... names keep working everywhere.

directory.json is personal and gitignored. It is entirely optional — without it every command still works, and an unresolvable alias fails immediately with the list of valid ones rather than silently falling back to a scan.

Message formatting

Chat supports *bold*, _italic_, ~strike~, `code`, triple-backtick code blocks, and <url|label> links. It does not support Markdown headings, tables, or []( ) links — they render literally.

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. Expired tokens refresh automatically.

© sanjay3290, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts) in skills/google-chat of sanjay3290/ai-skills.

  • SKILL.md
  • .gitignore
  • README.md
  • directory.example.json
  • requirements.txt
  • scripts/auth.py
  • scripts/chat.py

Open the folder on GitHubat commit 281d88d

Compare with similar skills

Google Chat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Chat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Chat this skillsanjay3290/ai-skills431—~1.2kAutomated safety check: PassApache-2.0
Google Workspace Authbobmatnyc/claude-mpm155—~718Automated safety check: NotesMIT
Google WorkspaceRedWoodOG/Hermes-Desktop1771 repos~2.1kAutomated safety check: PassMIT
Detecting Email Account Compromisemukul975/Anthropic-Cybersecurity-Skills34k—~823Automated safety check: PassApache-2.0
GCP Workspace Pivotwgpsec/AboutSecurity1.8k—~2.9kAutomated safety check: PassNone
Pp Workspace Adminmvanhorn/printing-press-library2.1k—~11kAutomated safety check: NotesApache-2.0

Similar skills

  • Google Workspace Auth

    bobmatnyc/claude-mpm

    Re-authenticate Google Workspace MCP in-flight - refresh tokens, setup OAuth, check status

    155 GitHub stars~718 tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Google Workspace

    RedWoodOG/Hermes-Desktop

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration via Python.

    177 GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed
  • Detecting Email Account Compromise

    mukul975/Anthropic-Cybersecurity-Skills

    Detect compromised O365 and Google Workspace email accounts by analyzing Unified Audit Logs and Azure AD sign-in logs for impossible travel, inbox rule creation/deletion (Set-InboxRule…

    34k GitHub stars~823 tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • GCP Workspace Pivot

    wgpsec/AboutSecurity

    GCP 到 Google Workspace 的穿越攻击方法论。当已获取 GCP Service Account 或 Project 权限并发现目标组织使用 Google Workspace、需要从云平台穿越到企业邮件/文档/管理控制台、或发现 Domain-Wide Delegation 配置时使用。覆盖 Domain-Wide Delegation 滥用、OAuth…

    1.8k GitHub stars~2.9k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Pp Workspace Admin

    mvanhorn/printing-press-library

    GAT-style Google Workspace auditing as an agent-native CLI: sync Directory, Drive, Gmail, Reports, and Alert Center into a local store, then run offline cross-API audits, offboarding, and OAuth-app…

    2.1k GitHub stars~11k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Google Workspace

    Tommy-yw/RunbookHermes

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for Hermes.

    546 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed

More from sanjay3290/ai-skills

All 24 skills in this repo
  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    431 GitHub starsUsed in 10 repos~683 tokens
    Auto-check: notes
  • Imagen

    sanjay3290/ai-skills

    Generate images using Google Gemini's image generation capabilities.

    431 GitHub starsUsed in 7 repos~657 tokens
    Auto-check passed
  • Whatsapp

    sanjay3290/ai-skills

    Send and receive WhatsApp messages via the unofficial linked-device client pywhats (pip install pywhats) — pair with QR, send text/images, group chat, read receipts, presence/typing, and a…

    431 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Notebooklm

    sanjay3290/ai-skills

    Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports.

    431 GitHub stars~655 tokensUpdated 27 days ago
    Auto-check passed
  • Elevenlabs

    sanjay3290/ai-skills

    Convert documents and text to audio using ElevenLabs text-to-speech.

    431 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Postgres

    sanjay3290/ai-skills

    Execute read-only SQL queries against multiple PostgreSQL databases.

    431 GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed

Questions about Google Chat

What does Google Chat do?

Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads, and manage spaces and DMs. Google Chat is an agent skill from sanjay3290/ai-skills. Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads, and manage spaces and DMs.

When should I use Google Chat?

Google Chat fits situations like: user asks to: send a message on Google Chat; read chat messages; list chat spaces; find a chat room.

How do I install Google Chat in Claude Code?

Run `npx skills add sanjay3290/ai-skills --skill google-chat -a claude-code`. Or copy the skill folder (skills/google-chat in sanjay3290/ai-skills) into .claude/skills/google-chat in your project. Claude Code loads it when a task matches its description.

How do I install Google Chat in Codex?

Run `npx skills add sanjay3290/ai-skills --skill google-chat -a codex`. Or copy the skill folder (skills/google-chat in sanjay3290/ai-skills) into .agents/skills/google-chat in your project. Codex loads it when a task matches its description.

Can I use Google Chat in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sanjay3290/ai-skills --skill google-chat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-chat, .gemini/skills/google-chat, .github/skills/google-chat and .opencode/skills/google-chat in your project.

What does Google Chat need to run?

Going by SKILL.md and its folder, Google Chat needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Google Chat access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Google Chat safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Google Chat use?

Google Chat is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Chat use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Chat?

Skills that share tags, products or a category with Google Chat: Google Workspace Auth (bobmatnyc/claude-mpm, 155 stars), Google Workspace (RedWoodOG/Hermes-Desktop, 177 stars), Detecting Email Account Compromise (mukul975/Anthropic-Cybersecurity-Skills, 34k stars) and GCP Workspace Pivot (wgpsec/AboutSecurity, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Chat?

sanjay3290 (a GitHub user) maintains it in sanjay3290/ai-skills, which has 431 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 10, 2026.

Source: sanjay3290/ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.