# google-mcp

Connects your Google calendar and spreadsheets to an AI assistant. Sign in with Google, no Cloud project of your own.

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

## What it does

The server speaks Streamable HTTP and runs at `https://g.mcp.openbsp.dev/mcp`. You skip the usual Google Cloud setup: sign in with Google, pick which products to connect, then copy the API key into your MCP client config. OAuth tokens sit encrypted at rest, and the encryption key is kept apart from the database.

Two tool groups ship with it. Calendar covers listing calendars and events, checking busy and free slots, plus creating, editing and removing events. Sheets covers reading and writing ranges, appending rows, creating spreadsheets, column schemas and row search, including search by meaning. Spreadsheet access is limited by the `drive.file` scope, so only files you picked during sign-in or files the app created are reachable. Call `list_authorized_files` to see what is available.

Your API key stays valid until you revoke it. Revoke with `curl -X DELETE https://g.mcp.openbsp.dev/key/YOUR_API_KEY` or from the Google permissions page. Either way the key stops working right away.

## Requirements
- Remote server: `https://g.mcp.openbsp.dev/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http google-mcp https://g.mcp.openbsp.dev/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add google-mcp --url https://g.mcp.openbsp.dev/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-mcp": {
            "url": "https://g.mcp.openbsp.dev/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-mcp": {
            "type": "http",
            "url": "https://g.mcp.openbsp.dev/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http google-mcp https://g.mcp.openbsp.dev/mcp
```

## When to use it
- check what is on the calendar this week
- book a meeting straight from the chat
- append rows to a budget spreadsheet
- find spreadsheet rows by meaning instead of exact text
- spin up a new spreadsheet and fill it

## Example prompts
- List my calendar events for tomorrow
- Create an event with the team on Friday at 3pm
- Search `Budget.xlsx` for rows about marketing

## Similar
- [Google Workspace](https://affpapa.org/en/nevibecode/mcp/google-workspace.md) — MCP server · ★ 192
- [google-calendar](https://affpapa.org/en/nevibecode/skills/google-calendar.md) — skill · 536 installs
- [google-multi-account](https://affpapa.org/en/nevibecode/plugins/google-multi-account.md) — plugin · ★ 5
- [google-sheets](https://affpapa.org/en/nevibecode/skills/sanjay3290-google-sheets.md) — skill · 465 installs
- [FGAC.ai: Multiple Gmail Accounts, Google Sheets & Docs](https://affpapa.org/en/nevibecode/mcp/fgacai-multiple-gmail-accounts-google-sheets-docs.md) — MCP server
- [recipe-create-events-from-sheet](https://affpapa.org/en/nevibecode/skills/recipe-create-events-from-sheet.md) — skill · 30100 installs

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