# Google Workspace

Links AI agents with Google tools like Gmail, Calendar, Drive, and Sheets. Operates locally across multiple accounts right from your chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 192
- Author: aaronsb
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aaronsb/google-workspace-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/google-workspace

## What it does

This server connects coding agents to eight Google services. Tools like `manage_email`, `manage_calendar`, and `manage_drive` handle everyday office tasks. Your assistant can inspect email threads, book calendar meetings, update Docs, or read spreadsheet ranges.

Authentication requires your own OAuth 2.0 Desktop app credentials from Google Cloud Console. All access tokens stay on your local disk. Without Node 22.12 or newer installed, the process will fail. The server handles multiple accounts directly, keeping personal and work profiles separated.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` — 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> --transport stdio google-workspace -- npx -y @aaronsb/google-workspace-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add google-workspace --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -- npx -y @aaronsb/google-workspace-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-workspace": {
            "command": "npx",
            "args": [
                "-y",
                "@aaronsb/google-workspace-mcp"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-workspace": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@aaronsb/google-workspace-mcp"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> google-workspace npx -y @aaronsb/google-workspace-mcp
```
Replace <…> with your own values

## When to use it
- search inbox messages and send replies in Gmail
- inspect availability and schedule events in Google Calendar
- write or fetch row values in Google Sheets
- organize checklists and create entries in Google Tasks

## Example prompts
- Check my calendar for tomorrow and list open slots in the afternoon.
- Look for recent emails from finance and download the attached spreadsheet.
- Append a new row to the quarterly budget sheet with yesterday's totals.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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