How do I install Gogcli?

Gogcli is a local plugin. Install it using npm package: gogcli-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Gogcli need?

Gogcli requires the following credentials or environment variables: GOG_ACCOUNT, GOG_PATH. You can find setup instructions on the server detail page.

What AI apps work with Gogcli?

Gogcli uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Gogcli MCP Server

by Chris Hall

Developer ToolsLow Risk10.0LocalNew

Free

Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets

About

Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (3 strong, 3 medium validity signals). 1 code issue detected. No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. Trust signals: trusted author (10/10 approved). 2 finding(s) downgraded by scanner intelligence.

15 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

What You'll Need

Set these up before or after installing:

Email address of the Google account to use (matches gogcli auth)Optional

Environment variable: GOG_ACCOUNT

Override path to the gogcli binary (auto-discovered otherwise)Optional

Environment variable: GOG_PATH

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-chrischall-gogcli-mcp": {
      "env": {
        "GOG_PATH": "your-gog-path-here",
        "GOG_ACCOUNT": "your-gog-account-here"
      },
      "args": [
        "-y",
        "gogcli-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

gogcli-mcp

A monorepo of Model Context Protocol servers that give Claude natural-language access to Google Workspace via gogcli.

[!WARNING] AI-developed project. This codebase was built and is actively maintained by Claude. Review all code and tool permissions before use.

Packages

Package	Tools	Description
gogcli-mcp	52	All services — Sheets, Docs, Gmail, Calendar, Drive, Tasks, Contacts, Auth
gogcli-mcp-sheets	35	Auth + full Sheets (base + 22 extra: tabs, formatting, named ranges, etc.)
gogcli-mcp-docs	26	Auth + full Docs (base + 14 extra: insert, export, sed, comments, etc.)

Each package is a standalone MCP server. Install whichever one fits your needs — you don't need to install more than one.

Prerequisites

Install gogcli

gogcli is the CLI that these MCP servers wrap. Install it for your platform:

macOS (Homebrew):

brew install steipete/tap/gogcli

macOS / Linux (binary):

curl -fsSL https://github.com/steipete/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
chmod +x /usr/local/bin/gog

Windows (Scoop):

scoop bucket add steipete https://github.com/steipete/scoop-bucket
scoop install gogcli

Windows (manual):

Download gog-windows-amd64.exe from the latest release, rename to gog.exe, and add to your PATH.

Authenticate

gog auth add your@gmail.com

This opens a browser for Google OAuth. For specific services only:

gog auth add your@gmail.com --services sheets,docs,drive

Install Node.js

Node.js 18 or later is required. Install via nodejs.org or:

brew install node        # macOS

Quick Start

# Install the package you want
npm install -g gogcli-mcp          # base
npm install -g gogcli-mcp-sheets   # extended sheets
npm install -g gogcli-mcp-docs     # extended docs

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gogcli": {
      "command": "gogcli-mcp",
      "env": {
        "GOG_ACCOUNT": "you@gmail.com"
      }
    }
  }
}

Replace gogcli-mcp with gogcli-mcp-sheets or gogcli-mcp-docs for extended packages.

Claude Code

claude mcp add gogcli -- gogcli-mcp

What you can do

Ask Claude things like:

"Read the data in Sheet1!A1:D20 of my budget spreadsheet"
"Append this week's expenses to my tracking sheet"
"Search my Gmail for invoices from last month"
"Create a calendar event for tomorrow at 3pm"
"List comments on my project doc"
"Export my doc as a PDF"

Multiple Accounts

All tools accept an optional account parameter:

Read Sheet1!A1:D10 from spreadsheet abc123 using my work account work@company.com

Development

npm install        # install all workspace dependencies
npm run build      # build all packages
npm test           # test all packages (267 tests, 100% coverage)
npm run typecheck  # typecheck all packages

Security

No credentials are stored or passed by these servers — authentication is handled by gogcli's keyring
All gogcli invocations use --no-input to prevent interactive prompts
All arguments are passed as arrays to child_process.spawn — no shell injection risk
GOG_ACCESS_TOKEN is stripped from the child process environment to prevent stale token auth