Skill318 repo starsupdated 1mo ago

google-chat

This Claude Code skill provides lightweight integration with Google Chat for Google Workspace accounts, enabling users to list spaces, send messages and files to spaces or direct messages, retrieve message history, manage threads, and create new spaces through command-line scripts with standalone OAuth authentication stored securely in system keyrings. Use it when you need to programmatically interact with Google Chat without requiring an MCP server or personal Gmail account support.

View source Repository: ai-skills

Install in Claude Code

Copy

git clone --depth 1 https://github.com/sanjay3290/ai-skills /tmp/google-chat && cp -r /tmp/google-chat/skills/google-chat ~/.claude/skills/google-chat

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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):
```bash
python scripts/auth.py login
```

Check authentication status:
```bash
python scripts/auth.py status
```

Logout when needed:
```bash
python scripts/auth.py logout
```

## Commands

All operations via `scripts/chat.py`. Auto-authenticates on first use if not logged in.

```bash
# 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.