About gogcli-mcp
gogcli-mcp connects Claude to Google Workspace through gogcli, for users who need to work across its services. Its tools cover spreadsheets, email, calendars, files, classroom, and more, with an API escape hatch and account selection.
Key features
- 01115 tools across 13 services
- 02Read and edit Google Sheets and Docs
- 03Search and send Gmail
- 04Manage Calendar events and Drive files
- 05Support Classroom, Chat, Slides, and Tasks
- 06Target a specific Google account
Use cases
- 01Update a spreadsheet and append rows
- 02Search email and send a reply
- 03Manage calendar events and Drive files
MCP support
Exposes gogcli-backed Google Workspace operations as MCP tools for Claude, including service-specific tools and a generic API call option. Tools can target a specified Google account.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y gogcli-mcpGOG_ACCOUNTEmail address of the Google account to use (matches gogcli auth)GOG_PATHOverride path to the gogcli binary (auto-discovered otherwise)DISPLAY_TZzone for *Display fields and for interpreting naive gog values; defaults to America/New_YorkGOG_GMAIL_TRUSTED_DOMAINSadditional domains excluded from external-recipient audit alertsGOG_READONLYblock all mutating gog API requests (injects gog's --readonly); set to 0/false/no/off (or unset) to allow writesGOG_TIMEZONEzone gog formats naive dates in; unset, runner.ts hands gog DISPLAY_TZ so the two cannot divergeLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
115Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| all | boolean | No | Include every Discovery API (including preview/less-common ones) instead of the curated default set |
| account | string | No | Google account email to use, e.g. [email protected] — must be the full address, not a bare username. Overrides the GOG_ACCOUNT env var. Omit to use the single configured account. |
Details
From the project READMEgogcli-mcp
Warning
AI-developed project. This codebase was built and is actively maintained by Claude Code. Review all code and tool permissions before use.
Base Model Context Protocol server that gives Claude access to Google Workspace via gogcli. Includes 115 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth.
For extended Sheets or Docs support, see gogcli-mcp-sheets and gogcli-mcp-docs.
Requirements
- gogcli installed and authenticated
- Node.js 22+
brew install gogcli
gog auth add [email protected]
Installation
npm install -g gogcli-mcp
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"gogcli": {
"command": "gogcli-mcp",
"env": {
"GOG_ACCOUNT": "[email protected]"
}
}
}
}
Claude Code
claude mcp add gogcli-mcp -- gogcli-mcp
Tools (115)
| Service | Tools | Includes |
|---|---|---|
| Sheets | 8 | get, update, append, clear, metadata, create, find-replace, run |
| Docs | 7 | info, cat, create, write, find-replace, structure, run |
| Gmail | 6 | search, get, send, reply, reply-all, run |
| Calendar | 7 | events, get, create, update, delete, respond, run |
| Drive | 11 | ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run |
| Slides | 7 | export, info, create, copy, list-slides, read-slide, run |
| Classroom | 25 | courses, students, teachers, roster, coursework, submissions (grade/return/turn-in/reclaim), announcements, topics, invitations, profile, run |
| Chat | 13 | spaces list/find/create, threads list, messages list/search/send, dm send/space, reactions list/create/delete, run |
| Apps Script | 8 | get, content, pull, create, deployments, versions, run-function, run |
| Tasks | 7 | lists, list, get, add, done, delete, run |
| Contacts | 5 | search, list, get, create, run |
| API | 3 | list, describe, call |
| Auth | 8 | list, status, health, services, add, add-url, add-complete, run |
All tools accept an optional account parameter to target a specific Google account.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.