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.
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.
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.
How to use
- Install the extension via
gemini extensions install workspace. - Authenticate with your Google account when prompted.
- Use natural language commands to interact with your Docs, Sheets, and Slides.
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'
Related on TokRepo
- AI Tools for Documentation -- Document management and editing tools
- AI Tools for Automation -- Workflow automation tools
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
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.
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.
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.
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.
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)
- Gemini CLI Documentation— Gemini CLI extensions for integrating external tools
- Google Docs API— Google Docs API for programmatic document access
- Google Sheets API— Google Sheets API for spreadsheet operations
Related on TokRepo
Source & Thanks
Created by Google. Licensed under Apache 2.0. gemini-cli-extensions/workspace Part of Gemini CLI — ⭐ 99,400+
Discussion
Related Assets
Claude-Flow — Multi-Agent Orchestration for Claude Code
Layers swarm and hive-mind multi-agent orchestration on top of Claude Code with 64 specialized agents, SQLite memory, and parallel execution.
ccusage — Real-Time Token Cost Tracker for Claude Code
CLI that reads ~/.claude logs and breaks down Claude Code token spend by day, session, and project — pluggable into your statusline.
SuperClaude — Workflow Framework for Claude Code
Adds 16+ slash commands, 9 cognitive personas, and a smart flag system to Claude Code in one pipx install.