google-workspace

name	google-workspace
description	Operate Google Docs, Google Sheets, and Gmail from this workspace using OAuth and uv. Use for reading/editing docs and sheets, and reading/drafting/sending mail.

Google Workspace Skill

This skill provides access to Google Docs, Sheets, and Gmail operations.

Installation

curl -fsSL https://skale.dev/install-gog-skill.sh | bash

The installer will prompt you for:

• Agent: pi or opencode
• Scope: global (~/.pi) or local (./.agents)
• Tools: also install gworkspace tools (~/.gworkspace)

Non-Interactive Mode

# Skip prompts with environment variables
AGENT=pi SCOPE=global curl -fsSL https://skale.dev/install-gog-skill.sh | bash

Update

curl -fsSL https://skale.dev/install-gog-skill.sh | bash
# Select "Update existing installation"

Commands

All commands are run from ~/.gworkspace:

Docs

cd ~/.gworkspace && uv run gworkspace docs recent 10
cd ~/.gworkspace && uv run gworkspace docs structure
cd ~/.gworkspace && uv run gworkspace docs append "Text"
cd ~/.gworkspace && uv run gworkspace docs --doc-id "<id>" download "/tmp/export" 1.0
cd ~/.gworkspace && uv run gworkspace docs upload "/tmp/export/doc.md" 1.2

Sheets

cd ~/.gworkspace && uv run gworkspace sheets read
cd ~/.gworkspace && uv run gworkspace sheets read "BOM!A1:Z100"
cd ~/.gworkspace && uv run gworkspace sheets update "BOM!A2:D2" "A|B|C|D"
cd ~/.gworkspace && uv run gworkspace sheets append "BOM!A:A" "Item|Desc|100"

Gmail

cd ~/.gworkspace && uv run gworkspace gmail list 10
cd ~/.gworkspace && uv run gworkspace gmail list 20 "from:example.com"
cd ~/.gworkspace && uv run gworkspace gmail get <message_id>
cd ~/.gworkspace && uv run gworkspace gmail body <message_id>
cd ~/.gworkspace && uv run gworkspace gmail draft "[e-mail]" "Subject" "Body"
cd ~/.gworkspace && uv run gworkspace gmail send --approve-send "[e-mail]" "Subject" "Body"

Credentials Setup

1. Go to Google Cloud Console
2. Create a project and OAuth 2.0 credentials (Desktop application)
3. Download JSON and save as ~/.gworkspace/client_secrets.json
4. Run any command to authenticate

Authentication Issues

If you see insufficient authentication scopes or invalid_scope:

rm -f ~/.gworkspace/token.json
cd ~/.gworkspace && uv run gworkspace gmail list 1

Email Footer

AI-created emails append footer from ~/.gworkspace/email_footer.md.

Default: gesendet von KI, iA

Customize:

echo "Your custom footer" > ~/.gworkspace/email_footer.md