# cli

> cli is an open-source AI tool for productivity. Command-line tool that exposes every Google Workspace API with JSON output for agents. It is available on CLI, macOS, Linux and Windows.

- **Kind:** Tool
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://developers.google.com/workspace
- **Repository:** https://github.com/googleworkspace/cli
- **GitHub stars:** 32,354
- **License:** Apache-2.0
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-14

## About

The gws command-line tool does not ship a fixed command list. At runtime it reads Google's Discovery Service and builds its command surface from it, so new Workspace API methods appear without an update. Output is structured JSON, and the project bundles more than 40 agent skills.

It covers Drive, Gmail, Calendar and other Workspace APIs. Installation is through npm, which needs Node 18 or later, or a prebuilt binary from GitHub releases. A Google Cloud project is required for OAuth credentials.

The README states it is not an officially supported Google product and is under active development with breaking changes expected before v1.0.

## Features

- **Dynamic commands:** Built from the Discovery Service at runtime.
- **JSON output:** Structured for scripts and agents.
- **Agent skills:** 40-plus bundled skills.
- **Broad API coverage:** Drive, Gmail, Calendar and more.
- **Binary or npm:** Two install routes.

## Good for

- Script Drive and Gmail tasks
- Give an agent access to Calendar
- Automate admin work from a shell

## FAQ

### Is it an official Google product?

No, the README says it is not officially supported.

### What do I need?

Node 18 or later or a binary, plus a Google Cloud project for OAuth.

### Will commands change?

Breaking changes are expected before v1.0.

### Licence?

Apache-2.0.

### Is cli free?

Yes. cli is open source, so you can use and self-host it for free.

### What are the best alternatives to cli?

The closest alternatives to cli are Praxy AI, ChatPDF, ChatDOC, MajorGen and to teach.

## Alternatives

- [Praxy AI](https://ai-powered.com/tools/praxy_ai): Praxy AI is an AI tool for productivity.
- [ChatPDF](https://ai-powered.com/tools/chatpdf): ChatPDF is a free AI tool for productivity.
- [ChatDOC](https://ai-powered.com/tools/chatdoc): ChatDOC is a free AI tool for productivity.
- [MajorGen](https://ai-powered.com/tools/majorgen): MajorGen is a paid AI tool for productivity.
- [to teach](https://ai-powered.com/tools/to_teach): to teach is a freemium AI tool for productivity.
- [Paraphrasing Tool](https://ai-powered.com/tools/paraphrasing_tool): Paraphrasing Tool is a freemium AI tool for productivity.
- [Ajelix](https://ai-powered.com/tools/ajelix): Ajelix is an AI tool for productivity.
- [Magick](https://ai-powered.com/tools/magick): Magick is an AI tool for productivity.

---
Source: https://ai-powered.com/tools/cli-7
