google-workspace-cli · hoodini — Claude Code skill: what it does, how to install
This skill lets an agent use the gws CLI for Google Workspace tasks, from handling Gmail and Drive to creating Calendar events. Use it to automate work across Workspace services.
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a claude-codeWhat google-workspace-cli does
The skill guides an agent to use gws for Google Workspace APIs. It can help manage Drive files, read and send Gmail, work with Calendar, Sheets, Docs and Slides, and access other Workspace services. The CLI builds its commands from Google's Discovery Service at runtime and returns structured JSON.
You need Node.js 18+, a Google Cloud project for OAuth, and a Google account with Workspace access. After installing the CLI, configure access with gws auth setup and gws auth login. Testing-mode OAuth apps have a limit of about 25 scopes, so the recommended preset of 85+ scopes will fail. Google does not officially support this project, and active development means commands may change before v1.0.
What it helps with
- find files in Google Drive
- read or send Gmail messages
- create a Google Calendar event
- fetch data from Google Sheets
- write content to Google Docs
Example prompts for the agent
- Find recent files in Google Drive and list their names.
- Read Gmail messages about the report and summarize them.
- Create a Google Calendar event from these details.
How to install google-workspace-cli
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a claude-code2Manually: put the files in place
~/.claude/skills/google-workspace-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/google-workspace-cli/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a codex2Manually: put the files in place
.agents/skills/google-workspace-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a cursor2Manually: put the files in place
.cursor/skills/google-workspace-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills google-workspace-cli2Manually: put the files in place
.github/skills/google-workspace-cli/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/google-workspace-cliManually: put the files in place
.devin/skills/google-workspace-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about google-workspace-cli
How do I install google-workspace-cli in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a claude-code. The skill file is at ~/.claude/skills/google-workspace-cli/SKILL.md.
What does google-workspace-cli do?
It helps an agent access Google Workspace services through the gws CLI, including Drive, Gmail, Calendar and Sheets.
What does google-workspace-cli require?
You need Node.js 18+, a Google Cloud project for OAuth, and a Google account with Workspace access. For an OAuth app in testing mode, choose individual scopes; the 85+ scope preset exceeds the stated limit of about 25.
Similar skills
All skills for Office documents →google-workspace-cli by other authors comes first.
