gws CLI
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
- 31,970 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- Gets OAuth access to mail, files and calendar
- Can send email and modify documents
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/gwsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Gets OAuth access to mail, files and calendar
- Can send email and modify documents
This is third-party code. Review the repository files before installing.
What it does
gws builds its command set at runtime from Google's Discovery Service, so new API methods show up without an update. Every response is structured JSON, with --dry-run, auto-pagination and method schema lookup via gws schema. The repository ships over a hundred SKILL.md files: one per API, helpers, and ready recipes for Gmail, Drive, Docs, Calendar and Sheets. It supports interactive OAuth, service accounts, pre-issued tokens and credential export for CI.
Who it is for. For people who want an agent to work with Google mail, documents and calendar without custom integrations.
Good fit when
- An agent needs to search mail, Drive files or calendar events
- You need to create spreadsheets and documents from scripts or CI
- You want to give Gemini CLI or another agent Workspace access in one install
Not a fit when
- Your team uses Yandex 360 or another office suite
- You cannot create a Google Cloud project and OAuth client
Example request
Find this week's emails from accounting in Gmail and save the attachments to a Drive folderLimitations
Not an officially supported Google product, and breaking changes are expected before 1.0. You need a Google Cloud project and OAuth client; unverified apps are limited in scopes, so the recommended preset may fail. Google Workspace availability from Russia is inconsistent.
How to disable. Remove the gws binary or the @googleworkspace/cli package, the ~/.config/gws credentials folder and any installed gws-* skills.
FAQ
Why does login fail with Access blocked?
For an OAuth app in testing mode, add your account under Test users on the consent screen.
How do I use it in CI without a browser?
Sign in on a machine with a browser, export credentials with gws auth export --unmasked and point GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE at the file.
Discussion
No questions or reviews yet.
Related
CLI toolsA Gemini CLI extension for working with Google Docs, Sheets, Slides, Gmail, Chat, Calendar and Drive from the terminal
One MCP server for Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat and Apps Script with OAuth 2.1
GSuite MCP
mcp-gsuite
A Python MCP server for Gmail and Google Calendar: search and read emails, drafts and replies, events with attendees, several accounts at once
Google Docs MCP: Docs, Sheets, Drive, Gmail and Calendar
Google Docs MCP
An MCP server giving an agent Google Docs, Sheets, Drive, Gmail, Calendar and Apps Script: reading, editing, mail and events; sign-in over OAuth
A set of everyday agent skills: web search, browser automation, Gmail, Google Calendar and Drive, speech transcription and YouTube transcripts
DingTalk Workspace CLI (dws)
DingTalk Workspace CLI
Official DingTalk CLI with agent skills: chats, calendar, todos, mail, docs and approvals of your organization from the terminal
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Repository stars | Main difference |
|---|---|---|---|
| gws (this entry) | no | 31,970 | |
| DingTalk Workspace CLI (dws) | yes | 3,843 | official DingTalk CLI with agent skills |
| HEY CLI | yes | 420 | a terminal CLI and TUI for HEY mail |
README in short
The README covers installing via binary, npm, cargo, Nix or Homebrew and a quick start with gws auth setup. It details auth methods and their precedence: token, credentials file, encrypted credentials in the OS keyring. There are sections on agent skills, the Gemini CLI extension, environment variables and exit codes. The project is marked unofficial and under active development.