HN

Need help?
<- Back
Google Workspace CLI

Google Workspace CLI

gonzalovargas

Comments (203)

  • ksri
    I have been working on extrasuite (https://github.com/think41/extrasuite). This is like terraform, but for google drive files.It provides a git like pull/push workflow to edit sheets/docs/slides. `pull` converts the google file into a local folder with agent friendly files. For example, a google sheet becomes a folder with a .tsv, a formula.json and so on. The agent simply edits these files and `push`es the changes. Similarly, a google doc becomes an XML file that is pure content. The agent edits it and calls push - the tool figures out the right batchUpdate API calls to bring the document in sync.None of the existing tools allow you to edit documents. Invoking batchUpdate directly is error prone and token inefficient. Extrasuite solves these issues.In addition, Extrasuite also uses a unique service token that is 1:1 mapped to the user. This means that edits show up as "Alice's agent" in google drive version history. This is secure - agents can only access the specific files or folders you explicitly share with the agent.This is still very much alpha - but we have been using this internally for our 100 member team. Google sheets, docs, forms and app scripts work great - all using the same pull/push metaphor. Google slides needs some work.
  • dnw
    Schema Discovery Service is interesting but I have been wondering whether it is finally time to start implementing HATEOAS[0] in REST services.[0] https://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypert...
  • jillesvangurp
    Generating a good cli isn't all that hard for agentic coding tools. When you do it manually it's highly repetitive work. But all you are doing is low level plumbing. Given some parsed arguments, call a function, return the result (with some formatting, prettying, etc.). In the end it's just a facade for an API, library, or whatever else you want to have a cli for. Easy to write. Easy to test. But manually going through your API resource by resource, parameter by parameter, etc. takes a long time. An LLM just blazes through that in a few minutes. Generate some tests, tweak as needed, and you are good to go.I did a few CLIs with codex in the last few weeks. I do simple ops with this stuff. I've had a few use cases for new features where previously I would have had to build some kind of quick and dirty admin UI just to use and test a new API feature before being able to integrate it into our product. With a generated cli, I can just play with it from the command line. Or make codex do that for me.A good cli with a modern command line argument parser, well documented options, bash/zsh auto complete, pretty colors, etc. is generally nice to have. I mapped resources to commands and sub commands, made it add parameters with sensible defaults or optional ones. Then I got lazy and just asked it what else it thought it was missing, it made some suggestions and I gave it the thumbs up and it all got added. I even generated a simple interactive TUI at some point. Because why not? I also made it generate a md skill file explaining how to use the cli that you can just drop in your skills directory.
  • tclancy
    Interesting post from the main contributor about this (at least I assume it’s what he’s referencing) https://justin.poehnelt.com/posts/rewrite-your-cli-for-ai-ag...
  • hrmtst93837
    > Disclaimer> This is not an officially supported Google product.Looked like an official Google Product on the first glance.
  • mogili1
    I was excited to see this but all of that went away when I realized you need to create an app in GCP to use it. Can't really expect non technical users to set this up across the company.
  • virgildotcodes
    God, getting this set up is frustrating. I've spent 45 minutes trying to get this to work, just following their defaults the whole way through.Multiple errors and issues along the way, now I'm on `gws auth login`, and trying to pick the oAuth scopes. I go ahead and trust their defaults and select `recommended`, only to get a warning that this is too many scopes and may error out (then why is this the recommended setting??), and then yeah, it errors out when trying to authenticate in the browser.The error tells me I need to verify my app, so I go to the app settings in my cloud console and try to verify and there's no streamlined way to do this. It seems the intended approach is for me to manually add, one by one, each of the 85 scopes that are on the "recommended" list, and then go through the actual verification.Have the people that built and released this actually tried to install and run this, just a single time, purely following their own happy path?
  • betaby
    I'm curious why `npm` is used to install a `rust` binary?
  • fergie
    > gws doesn't ship a static list of commands. It reads Google's own Discovery Service at runtime and builds its entire command surface dynamically.What is the practical difference between a "discovery service"+API and an MCP server? Surely humans and LLMs are better off using discovery service"+API in all cases? What would be the benefit of MCP?
  • mansilladev
    I remember reading gog setup instructions, and thinking, "Create oauth app/client? That's bonkers." And as cool+useful as this project looks, it's quite a bit harder to get going, especially if you're not familiar with Google Console and OAuth (or not a dev).Reading lots of comments about "MCP vs CLI" -- reminds me a bit of the "agent vs. script/app/rpa" debates. It's usually not one or the other, but rather, both.. or the right tool for the job (and that can shift over time).Biggest complaint we have about MCP is bigger context windows and token spend. Tools do exist that address this. I have just one MCP endpoint with a half dozen tools behind it, including Gmail, Google Calendar, Docs, Github, Notion, and more. Uses tool search tool (ToolIQ) with tiny context footprint. Give it a whirl. https://venn.ai
  • internet2000
    Claude Opus 4.6 couldn't figure out how to use it to write to a Google Sheet (something to do with escaping the !?) and fell back to calling the sheets API directly with gcloud auth.
  • plastic041
    The fact that humans can use this feels like a side effect. The developer says it's "built for agents first" and "AI agents would be the primary consumers of every command, every flag, and every byte of output"[1].[1] https://justin.poehnelt.com/posts/rewrite-your-cli-for-ai-ag...
  • benjaminwootton
    They need something like this as it's hard and flaky to automate Google apps with AI. However, step 2 drops me to a fairly technical looking page where I have to configure Google Cloud. If they had a one click installer to automate Google Apps it would be an absolute killer use case for AI for me.
  • avaer
    Is this basically a CLI version of [1]? If so, I'm glad Google is being forward thinking about how developers actually want to use their apps.Better this than a Google dashboard, or slopped together third party libs. I know Google says they don't support it, but they'll probably support it better than someone outside of Google can support it.[1] https://workspaceupdates.googleblog.com/2025/12/workspace-st...
  • pimlottc
    > gws doesn't ship a static list of commands.Clever, but frustrating that they don’t bother to provide any docs on the actual commands this supports.
  • iosjunkie
    Basically Google’s take on GAM https://github.com/GAM-team/GAM
  • benkaiser
    Would be nice if the MCP implemented the Streamable HTTP MCP spec instead of the CLI one. I know this is already a HTTP API, but making it available as an MCP server that clients like Joey[1] can consume easily over network would be nice.[1] https://github.com/benkaiser/joey-mcp-client
  • tgma
    "This is not an officially supported Google product."Probably someone's hobby project or 20% time at best.
  • shanehoban
    Feel like this should be at the top of the README - not the bottom> Disclaimer> Caution> This is not an officially supported Google product.
  • arjie
    I've been using `gog` but I'd rather have an agent-first thing. I don't want a big bad MCP that occupies all context all the time. I need my claw to be aware on how to edit things. As it so happens, right now `gog` works. But I'm eager to see how this develops.
  • epicprogrammer
    I've built a few internal tools using the Workspace APIs, and while they are powerful, the rate limits on the Drive API can be brutal if you are doing bulk operations. Does this repository handle automatic backoff and retries, or do we need to wrap it ourselves?
  • swaminarayan
    This reminds me a bit of how the GitHub CLI evolved into a foundation for automation and tooling. Do you see the Google Workspace CLI primarily as something for humans using the terminal, or more as a stable interface that automation and AI agents can build on?
  • lewisjoe
    How to expose my product suite's API to AI has been a roller coster ride. First it was tool calling hooks, then MCP, then later folks found out AI is better at coding so MCPs suddenly became code-mode, then people realized skills are better at context and eventually now Google has launched cli approach.Remember this repo is not an agent. It's just a cli tool to operate over gsuite documents that happens to have an MCP command and a bunch of skills prebundled.That's a new one. I guess the hope is agents are good at navigating cli and it also democratizes the ecosystem to be used by any agent as opposed to Microsoft (which only allows Copilot to work in its ecosystem)
  • sega_sai
    Interesting, but scary, given that this is not a google product. Who knows whether that breaks any TOS somehow.
  • drewda
    While I prefer Google's productivity apps to the Microsoft world in this case Google is just catching up to the APIs and tooling that Microsoft has provided for a long time: https://learn.microsoft.com/en-us/powershell/microsoftgraph/...
  • _wizard
    Neat. I've been running something very similar to this locally for a few months now. They introduced all their documentation into markdown recently. I still rely on discover API and lenient cloud project permissions, so maybe some gains there. Will compare note later.
  • OpenWaygate
    very similar to gogcli(https://github.com/steipete/gogcli), but in RUST
  • anon
    undefined
  • outlore
    Are integration vendors like Pipedream in trouble now that every company is pushing out MCP servers and CLIs to ride the AI craze? After the Twitter and Reddit API troubles of prior years, I can't imagine any company would willingly bring down the walls of their gardens and give easy access to precious user data. I'm waiting for the rug pull
  • cyrusradfar
    Correct me if I'm wrong but the UX difficulty with the Google API ecosystem isn't resolved. It's the goddamn permissioning and service accounts. Great to have a CLI that every other minute says, "you can't do this" -- the CLI really needed to solve this to check my boxes.
  • mace01
    Seems weird to require another tool (gcloud) to set it up, but it does look to be tightly integrated with google cloud.
  • skybrian
    Having the available commands change on you dynamically seems like an anti-pattern, but I suppose an AI can deal with it.
  • wonderfuly
    Why cli instead of just HTTP API doc? The agent can use curl or write code to send requests.
  • mmaunder
    Forget the Gemini extension - Gemini CLI sucks. Forget the MCP - MCP is beyond dead. But for codex or claude cli this is a game changer. Next question is how programmatic have they made the sheets interface... because Gemini sucks at sheets.
  • sbinnee
    I can already see all the CTOs are getting excited to plug this in their OpenClaw instances.
  • jngiam1
  • loveparade
    Great, i hope this becomes a trend now that agent skills want clis
  • larodi
    Would it help to backup all my mailboxes and be ready to ditch gmail?
  • hsaliak
    GCP Next is Apr 22-24. Hope this continues to live afer that.
  • shivam310
    I'm surprised that this didn't officially exist before.
  • mmaunder
    Google really know how to screw up a product experience.npm install -g @googleworkspace/cligws auth setup{ "error": { "code": 400, "message": "gcloud CLI not found. Install it from https://cloud.google.com/sdk/docs/install", "reason": "validationError" } }Which takes you to...https://docs.cloud.google.com/sdk/docs/install-sdkWhere you have to download a tarball, extract it and run a shell script.I mean how hard is it to just imitate everyone else out there and make it a straight up npm install?
  • arthurcolle
    My agents will follow this repo with great interest
  • fs111
    For the love of god, please google, give us personal access tokens and not this Oauth madness inside GCP. It is impossible to get that in any big enterprise.
  • anon
    undefined
  • jitl
    > quick setup> requires setting up gcloud cli first, necessitates making a Google Cloud projectcmon google how come even your attempts at good ux start out with bad ux? let me just oauth with my regular google account like every other cli tool out there. gh cli, claude, codex - all are a simple “click ok” in the browser to log in. wtf.and the slow setup - i need to make my own oauth app & keys??EDIT: oh yeah and get my oath app verified all so i can use it with my own account
  • sciencesama
    Would be useful if it can atleast show google drive storage in folder structure
  • yakkomajuri
    For all people have to say about Pete the openclaw guy he's been perhaps one of the most vocal voices about CLIs > MCPs (or maybe his is just the loudest?) and he also built a GSuite CLI that probably inspired this project.I mean it's great that we get this, hopefully it can continue to be maintained and I'd love to see a push for similar stuff for other products and at other companies.
  • tedk-42
    Haha in the world of AI/MCPs, all of a sudden we have a push for companies to properly build out APIs/CLI tools.
  • lloydatkinson
    Google will wait for businesses to become very coupled to this and then kill off the CLI just because.
  • pdyc
    wow this will gel very well with my current project. Main hurdle i was facing was connecting with individual services via google oauth to get the data.
  • javadhu
    Nice, now I can use this alongside claude to auto document my research work.Also, what I find fascinating is that the repo was initialized 3 days ago so it seems it's still a work in progress.
  • evanjrowley
    Hoping Apple will do the same with iCloud.
  • blondin
    This is a very interesting way of building agent skills. Seems like the imperative way of orchestration/automation is making a comeback.
  • gbrindisi
    the most annoying thing with Google Workspace is that you need super admin privilege to properly audit the environment programmatically, I believe because of the cloud-identity api.
  • ernsheong
    Archived in 3… 2… 1…
  • mosajjal
    AI Agents are becoming first-class citizens for SaaS
  • sjeiuhvdiidi
    Very uninteresting post. Why is this the number one post on Hacker News ? Honestly, absolutely disgusting and you can be ashamed, or ashamed for them.
  • bpiroman
    written in Rust lol
  • tonymet
    [flagged]
  • shubhamintech
    [flagged]