SkillsMar 29, 2026·1 min read

Gemini CLI Extension: Workspace — Google Docs & Sheets

Gemini CLI extension for Google Workspace. Read, create, and edit Google Docs, Sheets, and Slides from your terminal.

TL;DR
This Gemini CLI extension lets you read, create, and edit Google Docs, Sheets, and Slides from the terminal.
§01

What it is

This is a Gemini CLI extension that integrates Google Workspace (Docs, Sheets, and Slides) into your terminal workflow. It allows you to read document content, create new documents, edit existing ones, and manipulate spreadsheet data -- all through Gemini CLI commands without opening a browser.

This extension is for developers and power users who use Gemini CLI and want to interact with Google Workspace documents programmatically from their terminal.

The project is actively maintained with regular releases and a growing user community. Documentation covers common use cases, and the open-source nature means you can inspect the source code, contribute fixes, and adapt the tool to your specific requirements.

§02

How it saves time or tokens

Switching between the terminal and browser to copy data from Google Sheets or update a Google Doc breaks flow. This extension lets Gemini agents access Workspace data directly, enabling workflows like generating reports from Sheets data, updating project docs, or creating slide decks -- all without leaving the CLI.

§03

How to use

  1. Install the extension via gemini extensions install workspace.
  2. Authenticate with your Google account when prompted.
  3. Use natural language commands to interact with your Docs, Sheets, and Slides.
§04

Example

# Install the extension
gemini extensions install workspace

# Read a Google Doc
gemini 'Read the contents of my Project Plan doc'

# Create a new spreadsheet
gemini 'Create a Google Sheet with columns Name, Email, Role and add 3 sample rows'

# Update a slide deck
gemini 'Add a new slide to my Q2 Review presentation with the title Summary'
§05

Related on TokRepo

§06

Common pitfalls

  • The extension requires OAuth consent for Google Workspace scopes. Organization-managed Google accounts may need admin approval before the extension can access documents.
  • Large spreadsheets with thousands of rows may hit API rate limits. Batch operations or filter the data range before processing.
  • Document formatting may not fully round-trip. Complex formatting in Google Docs (tables, embedded images) may be simplified when read through the CLI.

Before adopting this tool, evaluate whether it fits your team's existing workflow. Read the official documentation thoroughly, and start with a small proof-of-concept rather than a full migration. Community forums, GitHub issues, and Stack Overflow are valuable resources when you encounter edge cases not covered in the documentation.

Frequently Asked Questions

Which Google Workspace apps does this extension support?+

The extension supports Google Docs, Google Sheets, and Google Slides. You can read, create, and edit documents across all three applications from the Gemini CLI.

Does this extension require a Google Workspace subscription?+

No. The extension works with free Google accounts and Google Workspace (paid) accounts. It uses the Google Docs, Sheets, and Slides APIs, which are available to all Google account holders.

How does authentication work?+

On first use, the extension opens a browser window for Google OAuth consent. Once authorized, the credentials are cached locally. You do not need to re-authenticate on subsequent uses unless you revoke access.

Can I use this extension in CI/CD pipelines?+

Yes, with a service account. For non-interactive environments, configure a Google service account with the appropriate API scopes and pass the credentials via environment variables.

Is my document data sent to Gemini?+

The extension reads document content through the Google APIs and passes it to Gemini for processing. If you use Gemini to summarize or edit a document, the content is sent to the Gemini model. Review your organization's data policies before using it with sensitive documents.

Citations (3)
🙏

Source & Thanks

Created by Google. Licensed under Apache 2.0. gemini-cli-extensions/workspace Part of Gemini CLI — ⭐ 99,400+

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets