{
  "markdown": "# gogcli-mcp\n\n[![CI](https://github.com/chrischall/gogcli-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/chrischall/gogcli-mcp/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/gogcli-mcp)](https://www.npmjs.com/package/gogcli-mcp)\n[![coverage: 100%](https://img.shields.io/badge/coverage-100%25-brightgreen)](packages/gogcli-mcp/vitest.config.ts)\n[![license](https://img.shields.io/npm/l/gogcli-mcp)](https://www.npmjs.com/package/gogcli-mcp)\n\nA monorepo of [Model Context Protocol](https://modelcontextprotocol.io) servers that give Claude natural-language access to Google Workspace via [gogcli](https://github.com/openclaw/gogcli).\n\n> [!WARNING]\n> **AI-developed project.** This codebase was built and is actively maintained by Claude. Review all code and tool permissions before use.\n\n## Packages\n\n| Package | Tools | Description |\n|---------|-------|-------------|\n| [gogcli-mcp](packages/gogcli-mcp) | 52 | All services — Sheets, Docs, Gmail, Calendar, Drive, Tasks, Contacts, Auth |\n| [gogcli-mcp-sheets](packages/gogcli-mcp-sheets) | 35 | Auth + full Sheets (base + 22 extra: tabs, formatting, named ranges, etc.) |\n| [gogcli-mcp-docs](packages/gogcli-mcp-docs) | 26 | Auth + full Docs (base + 14 extra: insert, export, sed, comments, etc.) |\n\nEach package is a **standalone** MCP server. Install whichever one fits your needs — you don't need to install more than one.\n\n## Prerequisites\n\n### Acknowledgement of Terms\n\nBy using this MCP server, you acknowledge and agree to the following:\n\n**1. This server accesses your own Google Workspace data via Google's official APIs** (Gmail, Calendar, Drive, Sheets, Docs, Contacts). Auth happens via OAuth, with your explicit consent at each scope. It does not — and cannot — access anyone else's Google account or shared content you don't have permission to read.\n\n**2. [Google's APIs Terms of Service](https://developers.google.com/terms) govern your use of this server**, in addition to any [Google Workspace Acceptable Use Policy](https://workspace.google.com/terms/use_policy.html) your domain admin enforces. The clauses most relevant here:\n\n> Google sets and enforces limits on your use of the APIs (e.g. limiting the number of API requests that you may make or the number of users you may serve), in our sole discretion.\n\nAnd on credentials, which is the most-tripped-on clause for open-source projects:\n\n> You will keep your credentials confidential and make reasonable efforts to prevent and discourage other API Clients from using your credentials. **Developer credentials may not be embedded in open source projects.**\n\nYou are agreeing to those terms — read by the maintainer 2026-05-23 — every time you invoke a tool in this server.\n\n**3. You must configure your own OAuth client.** This MCP does **not** ship an embedded `client_secret.json`. You register your own OAuth client at https://console.cloud.google.com/, scope it to your own user/project, and authorize it for the Workspace APIs you want to use. Do not check `client_secret.json`, `credentials.json`, or any refresh tokens into git — these are credentials and Google's ToS explicitly prohibits embedding them in OSS.\n\n**4. Personal, single-user use only.** This project is not affiliated with, endorsed by, sponsored by, or in partnership with Google LLC. It is a personal automation tool for one Google account holder to read and write their own Workspace content. Do not use it to bulk-extract Workspace data from your org, automate against other users' accounts, or build a multi-tenant SaaS on top of it. If you want to do those things, you need a verified app, a domain-wide-delegation service account, and a Workspace admin's blessing — none of which this MCP provides.\n\n**5. Your domain admin's policy may add restrictions.** If you're using a corporate Google Workspace account, your admin may restrict third-party OAuth apps, prohibit data exfiltration, or require app verification. **Check with your IT admin** before authorizing this MCP against a corporate domain.\n\n**6. You accept full responsibility** for any consequences of using this server in connection with your Google account — quota exhaustion (Gmail and Drive APIs have aggressive per-user quotas), token revocation, account warnings, your domain admin emailing you, or any enforcement action. If Google or your domain admin objects to your use, stop using this server.\n\nThis section is the maintainer's good-faith summary of the terms — it is not legal advice and does not modify or supersede Google's actual APIs ToS or your domain's policies.\n\n## Install gogcli\n\n[gogcli](https://github.com/openclaw/gogcli) is the CLI that these MCP servers wrap. Install it for your platform:\n\n**macOS (Homebrew):**\n```bash\nbrew install steipete/tap/gogcli\n```\n\n**macOS / Linux (binary):**\n```bash\ncurl -fsSL https://github.com/openclaw/gogcli/releases/latest/download/gog-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') -o /usr/local/bin/gog\nchmod +x /usr/local/bin/gog\n```\n\n**Windows (Scoop):**\n```powershell\nscoop bucket add steipete https://github.com/steipete/scoop-bucket\nscoop install gogcli\n```\n\n**Windows (manual):**\n\nDownload `gog-windows-amd64.exe` from the [latest release](https://github.com/openclaw/gogcli/releases/latest), rename to `gog.exe`, and add to your PATH.\n\n### Authenticate\n\n```bash\ngog auth add your@gmail.com\n```\n\nThis opens a browser for Google OAuth. For specific services only:\n\n```bash\ngog auth add your@gmail.com --services sheets,docs,drive\n```\n\n### Install Node.js\n\nNode.js 18 or later is required. Install via [nodejs.org](https://nodejs.org) or:\n\n```bash\nbrew install node        # macOS\n```\n\n## Quick Start\n\n```bash\n# Install the package you want\nnpm install -g gogcli-mcp          # base\nnpm install -g gogcli-mcp-sheets   # extended sheets\nnpm install -g gogcli-mcp-docs     # extended docs\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gogcli\": {\n      \"command\": \"gogcli-mcp\",\n      \"env\": {\n        \"GOG_ACCOUNT\": \"you@gmail.com\"\n      }\n    }\n  }\n}\n```\n\nReplace `gogcli-mcp` with `gogcli-mcp-sheets` or `gogcli-mcp-docs` for extended packages.\n\n### Claude Code\n\n```bash\nclaude mcp add gogcli -- gogcli-mcp\n```\n\n## What you can do\n\nAsk Claude things like:\n\n- *\"Read the data in Sheet1!A1:D20 of my budget spreadsheet\"*\n- *\"Append this week's expenses to my tracking sheet\"*\n- *\"Search my Gmail for invoices from last month\"*\n- *\"Create a calendar event for tomorrow at 3pm\"*\n- *\"List comments on my project doc\"*\n- *\"Export my doc as a PDF\"*\n\n## Multiple Accounts\n\nAll tools accept an optional `account` parameter:\n\n```\nRead Sheet1!A1:D10 from spreadsheet abc123 using my work account work@company.com\n```\n\n## Development\n\n```bash\nnpm install        # install all workspace dependencies\nnpm run build      # build all packages\nnpm test           # test all packages (267 tests, 100% coverage)\nnpm run typecheck  # typecheck all packages\n```\n\n## Security\n\n- No credentials are stored or passed by these servers — authentication is handled by gogcli's keyring\n- All gogcli invocations use `--no-input` to prevent interactive prompts\n- All arguments are passed as arrays to `child_process.spawn` — no shell injection risk\n- `GOG_ACCESS_TOKEN` is stripped from the child process environment to prevent stale token auth\n\n## License\n\nMIT\n",
  "bytes": 7424,
  "sha": "7fb26702e9b53848ef9887c44fc6209e3c598ed73295e70b01be2f7be7a6a468",
  "repo_slug": "chrischall/gogcli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_chrischall_gogcli_mcp_docs_b3b42984/readme"
}