Repolode
投稿する
googleworkspace

googleworkspace/cli

A command-line tool that gives one interface to Google Workspace APIs like Drive, Gmail, Calendar, Sheets, Docs, and Chat, with JSON output for scripts and AI agents.

GitHub で見る公式サイト
スター
31,672
フォーク
2,017
未解決の Issue
136
最終コミット
13 日前

これは何？

gws is a command-line client for Google Workspace. Instead of hand-writing curl calls against REST endpoints, you run commands such as gws drive files list or gws sheets spreadsheets create. The command set is built at runtime from Google's Discovery Service, so newly added API methods become available without a tool update. Every resource has --help, --dry-run previews a request before it is sent, and --page-all streams paginated results as NDJSON.

All output, including errors, is structured JSON, which makes the tool easy to pipe into jq or other scripts. The repository also ships over 100 Agent Skills (SKILL.md files) covering each supported API plus higher-level workflow helpers, and a Gemini CLI extension that lets an agent use the same commands with the authentication you already set up.

Authentication supports interactive OAuth login with encrypted local storage, manual Google Cloud OAuth client setup, service accounts, pre-obtained access tokens, and exported credentials for headless CI. Installation is available through GitHub Releases, npm, Cargo, Nix, and Homebrew. The project is written in Rust, is Apache-2.0 licensed, and is stated to be under active development with possible breaking changes before v1.0.

主な機能

  • 01Dynamically builds commands from Google's Discovery Service, so new API methods appear automatically.
  • 02Outputs structured JSON for every response, including errors.
  • 03Supports --dry-run to preview requests and --page-all for NDJSON pagination.
  • 04Ships 100+ Agent Skills and a Gemini CLI extension for AI agent use.
  • 05Offers multiple auth paths: interactive OAuth, service accounts, access tokens, and exported credentials for CI.

ユースケース

  • Scripting routine Drive, Sheets, or Gmail operations from a terminal or CI job.
  • Letting an AI agent read calendars, send emails, or update spreadsheets through structured commands.
  • Automating Google Chat notifications, such as posting a message after a deploy.
  • Piping Workspace data into jq or other shell tools for reporting.

トピック

#google-workspace#cli#google-api#ai-agent#automation#oauth2#rust#agent-skills#discovery-api#gemini-cli-extension

よくある質問

cli とは？
A command-line tool that gives one interface to Google Workspace APIs like Drive, Gmail, Calendar, Sheets, Docs, and Chat, with JSON output for scripts and AI agents. gws is a command-line client for Google Workspace. Instead of hand-writing curl calls against REST endpoints, you run commands such as gws drive files list or gws sheets spreadsheets create. The command set is built at runtime from Google's Discovery Service, so newly added API methods become available without a tool update. Every resource has --help, --dry-run previews a request before it is sent, and --page-all streams paginated results as NDJSON.
cli は無料で使えますか？ライセンスは？
cli は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
cli は今もメンテナンスされていますか？
活発にメンテナンス中。cli の最終コミットは 2026年10月6日 です。
cli は何に使えますか？
Scripting routine Drive, Sheets, or Gmail operations from a terminal or CI job. Letting an AI agent read calendars, send emails, or update spreadsheets through structured commands. Automating Google Chat notifications, such as posting a message after a deploy. Piping Workspace data into jq or other shell tools for reporting.
cli はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/googleworkspace/cli

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト