Skip to content

README.md

Latest commit

 

History

History
107 lines (72 loc) · 3.11 KB

README.md

File metadata and controls

107 lines (72 loc) · 3.11 KB

Google Chat Skill

An AI agent skill for interacting with Google Chat - list spaces, send messages, read conversations, and manage DMs. Works with Claude Code, Gemini CLI, Cursor, OpenAI Codex, Goose, and other AI clients supporting the Agent Skills Standard.

Features

  • List Spaces - View all Chat spaces you're a member of
  • Find Spaces - Search for spaces by name
  • Send Messages - Post messages to any space
  • Direct Messages - Send DMs to users
  • Read Messages - Get conversation history from spaces
  • Create Spaces - Set up new spaces with members

Lightweight alternative to the full Google Workspace MCP server.

⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.

Quick Start

1. Install dependencies

pip install keyring

2. Authenticate

python scripts/auth.py login

This opens a browser for Google OAuth. Tokens are stored securely in your system keyring.

3. Test connection

python scripts/auth.py status

Usage Examples

# 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 direct message
python scripts/chat.py send-dm user@example.com "Hey, quick question..."

# 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

Command Reference

Command Description Arguments
list-spaces List all spaces -
find-space <name> Find space by name space name
get-messages <space> Get messages from space space ID, --limit
send-message <space> <text> Send message space ID, message text
send-dm <email> <text> Send direct message user email, message text
find-dm <email> Find/create DM space user email
list-threads <space> List threads space ID
setup-space <name> [emails...] Create space name, member emails

Space Name Format

Google Chat uses spaces/AAAA123 format for space IDs. Get space names from list-spaces or find-space output.

Token Management

Tokens stored securely using the system keyring:

  • macOS: Keychain
  • Windows: Windows Credential Locker
  • Linux: Secret Service API (GNOME Keyring, KDE Wallet)

Service name: google-chat-skill-oauth

Troubleshooting

"Failed to get access token"

Run python scripts/auth.py login to authenticate.

"Space not found"

Verify the space ID format (spaces/AAAA123). Use list-spaces to get valid IDs.

"Permission denied"

You may not be a member of the space. Check your Google Chat membership.

License

Apache 2.0