# Google Workspace

Connects AI agents to Gmail, Drive, Docs, and Calendar. Gives coding assistants access to emails, files, and scheduling via 124 tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: mindstone
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/google-workspace
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/mindstone-google-workspace

## What it does

This connector equips AI agents with 124 tools spanning Gmail, Drive, Calendar, Docs, Sheets, Slides, Tasks, and Meet. It lets models search email threads, send messages, inspect calendar openings, or manipulate files directly in Google storage.

Authentication differs from typical standalone servers. The connector runs no local OAuth callback server and creates no sign-in links on its own. Instead, the host environment carries out the OAuth process and drops credential files into a dedicated path alongside an `accounts.json` index. When tokens are missing, calls stop and emit an `auth_required` status.

Running this tool requires Node.js 20 or newer along with valid `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET` values. You can also configure request timeouts via `GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `ACCOUNTS_PATH`, `CREDENTIALS_PATH`, `GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS`, `GOOGLE_WORKSPACE_DISABLE_REFRESH`, `MCP_WORKSPACE_PATH`, `WORKSPACE_BASE_PATH`, `GAUTH_FILE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Google Workspace

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env ACCOUNTS_PATH=<ACCOUNTS_PATH> --env CREDENTIALS_PATH=<CREDENTIALS_PATH> --env GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> --transport stdio google-workspace -- npx -y @mindstone/mcp-server-google-workspace
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add google-workspace --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env ACCOUNTS_PATH=<ACCOUNTS_PATH> --env CREDENTIALS_PATH=<CREDENTIALS_PATH> --env GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> -- npx -y @mindstone/mcp-server-google-workspace
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-workspace": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-google-workspace"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
                "ACCOUNTS_PATH": "<ACCOUNTS_PATH>",
                "CREDENTIALS_PATH": "<CREDENTIALS_PATH>",
                "GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS": "<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values. 4 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-workspace": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-google-workspace"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
                "ACCOUNTS_PATH": "<ACCOUNTS_PATH>",
                "CREDENTIALS_PATH": "<CREDENTIALS_PATH>",
                "GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS": "<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -e ACCOUNTS_PATH=<ACCOUNTS_PATH> -e CREDENTIALS_PATH=<CREDENTIALS_PATH> -e GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> google-workspace npx -y @mindstone/mcp-server-google-workspace
```
Replace <…> with your own values. 4 more environment variables are in the server README

## When to use it
- search email threads in Gmail and draft replies
- inspect calendar availability and schedule appointments
- search, retrieve, and organize files in Google Drive
- create and edit content inside Google Docs

## Example prompts
- Find the email from Sarah about yesterday's sprint planning and reply that I am reviewing it.
- List my open calendar slots for tomorrow afternoon.
- Look up the quarterly slide deck on Google Drive and summarize the recent edits.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

## Other versions with the same name
- [Google Workspace · aaronsb](https://affpapa.org/en/nevibecode/mcp/google-workspace.md) — ★ 192

From the same set: [mindstone/mcp-servers](https://affpapa.org/en/nevibecode/by/mindstone/mcp-servers.md) — 40 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
