gw
Skill4 starsChanged 6 months agoMITView on GitHub
CLI-first interface for Gmail, Google Drive, and Google Calendar. Designed for Claude Code agent integration. Uses --json flag throughout. Falls back to google-workspace-mcp for bulk/batch operations or complex multi-step flows. Source: https://github.com/googleworkspace/cli Use google-workspace-mcp tools when: - Bulk operations across many files/messages - Complex Docs/Sheets/Slides editing (batch_update_doc, modify_sheet_values) - Forms, Tasks, Contacts, Chat — not covered by gw CLI - Multi-step workflows needing in-session state
In this repository79 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- 21st-magicSkill
- alpacaSkill
- ask-mattSkill
- autoresearchSkill
- auto-stage-commitSkill
- browser-harnessSkill
- codebase-designSkill
- codeburnSkill
- codex-reviewSkill
- compact-memorySkill
- connect-recommendSkill
- connect-required-verification-informationSkill
- decision-mappingSkill
- delegate-taskSkill
- design-an-interfaceSkill
- design-mdSkill
- diagnosing-bugsSkill
- domain-modelingSkill
- edit-articleSkill
- extract-designSkill
- ffmpegSkill
- find-skillsSkill
- firecrawlSkill
- generateSkill
- git-guardrails-claude-codeSkill
- grillingSkill
- grill-me-codexSkill
- grill-meSkill
- grill-with-docs-codexSkill
- grill-with-docsSkill
- handoffSkill
- implementSkill
- improve-codebase-architectureSkill
- kie-aiSkill
- lightragSkill
- llmfitSkill
- loop-meSkill
- migrate-to-shoehornSkill
- notebooklmSkill
- obsidian-vaultSkill
- openspaceSkill
- playwrightSkill
- prototypeSkill
- qaSkill
- request-refactor-planSkill
- resolving-merge-conflictsSkill
- reviewSkill
- roastSkill
- scaffold-exercisesSkill
- session-handoffSkill
- setup-matt-pocock-skillsSkill
- setup-pre-commitSkill
- site-teardownSkill
- skill-discoverySkill
- skilluiSkill
- spline-3dSkill
- stripe-appsSkill
- stripe-best-practicesSkill
- stripe-directorySkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Check free/busy availability
- Very specific: line 75
Use google-workspace-mcp tools when:
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
gw — Google Workspace CLI
CLI-first interface for Gmail, Google Drive, and Google Calendar. Designed for Claude Code agent integration. Uses --json flag throughout. Falls back to google-workspace-mcp for bulk/batch operations or complex multi-step flows.
Source: https://github.com/googleworkspace/cli
When to use
- Send/read/reply to Gmail
- List, upload, share Drive files
- List, create, update, delete Calendar events
- Check free/busy availability
- Save email attachments to Drive
- Multi-account Google Workspace
Auth
gw auth login # OAuth browser flow — one-time per account
gw auth list # list registered accounts
gw auth status # show active account
gw auth switch user@example.com # switch active account
gw auth remove user@example.com # remove accountGmail
gw mail list --json # list recent messages
gw mail list --json --query "from:boss" # search messages
gw mail read <message-id> --json # read a message (no mark-read)
gw mail send --to user@example.com --subject "Subject" --body "Body"
gw mail reply <message-id> --body "Reply"
gw mail label <message-id> --add STARRED
gw mail mark <message-id> --read
gw mail labels --json # list all labels
gw mail attachments <message-id> --json # list attachments
gw mail download <message-id> <attachment-id> --output ./file.pdf
gw mail to-drive <message-id> <attachment-id> # save attachment to DriveDrive
gw drive list --json # list files
gw drive list --json --query "name='report'" # search
gw drive upload ./file.pdf --name "Report"
gw drive create doc --name "New Doc" # doc/sheet/slide
gw drive share <file-id> --email user@example.com --role reader
gw drive unshare <file-id> --email user@example.comCalendar
gw cal list --json # list upcoming events
gw cal list --json --days 7 # next 7 days
gw cal get <event-id> --json
gw cal create --title "Meeting" --start "2026-07-01T10:00" --end "2026-07-01T11:00"
gw cal update <event-id> --title "Updated"
gw cal delete <event-id>
gw cal free --start "2026-07-01" --end "2026-07-02" --json # free/busy checkMulti-account
# Per-command account override
gw --account work@company.com mail list --json
gw --account personal@gmail.com cal list --jsonMCP fallback (google-workspace-mcp)
Use google-workspace-mcp tools when:
- Bulk operations across many files/messages
- Complex Docs/Sheets/Slides editing (batch_update_doc, modify_sheet_values)
- Forms, Tasks, Contacts, Chat — not covered by
gwCLI - Multi-step workflows needing in-session state
Config
gw config show # show current config
gw config set key valueDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

