Google Workspace Extension for Gemini CLI
A Gemini CLI extension for working with Google Docs, Sheets, Slides, Gmail, Chat, Calendar and Drive from the terminal
Install
gemini extensions install https://github.com/gemini-cli-extensions/workspaceSign in to your Google account before use.
This is third-party code. Review the repository files before installing.
What it does
The extension adds an MCP server to Gemini CLI with access to your Google Workspace account. The agent creates and edits docs, sheets and slides, searches Drive, reads mail and chat, and checks or schedules calendar events. It ships ready commands such as /calendar:get-schedule for a day's schedule and /drive:search for file search. Headless machines can log in through a separate utility that prints an OAuth link.
Who it is for. For Gemini CLI users whose documents, mail and calendar live in Google Workspace.
Good fit when
- You need to create or update a Google Doc from the terminal
- You want your schedule or a Drive file without opening a browser
- You need to pull mail and documents into one summary
Not a fit when
- The agent would process mail or documents from untrusted sources
- You do not use Gemini CLI
Example request
What's on my calendar tomorrow? Also find the quarterly plan file in DriveLimitations
Works only as a Gemini CLI extension and needs a Google account login. The server can read, change and delete account data, and the authors warn explicitly about prompt injection through mail and documents. Google services and the Gemini API are unreliable or unavailable from Russia without a VPN.
How to disable. Run gemini extensions uninstall workspace and revoke the app's access in your Google account security settings.
Security check
- Reads, changes and deletes the account's mail, documents and events
- Exposed to prompt injection from incoming mail and documents
README in short
The README shows a one-command install and sample prompts: create a doc, check the calendar, find a file. It covers extension commands, headless login and self-hosting. A large section addresses indirect prompt injection risk. Apache 2.0 licensed.
FAQ
How do I log in on a machine without a browser?
Use npm run auth-utils -- login: it prints an OAuth link you can open on any device, and the credentials you paste back stay out of the model context.
Can I host my own infrastructure?
Yes, the docs include a guide for recreating the required resources in your own GCP project.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search