# Google Drive MCP

Connects your coding agent to Google Drive, Docs, Sheets, Slides, and Calendar. Useful for managing Workspace files and editing documents directly from prompts.

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

## What it does

The server packages 130 tools tailored for Google Workspace. An agent can organize folders on Drive, write text into Docs, format rows in Sheets, generate slide decks, and schedule Calendar events with Meet links. It also provides a `gdrive:///` URI scheme for browsing and direct file reads.

Local setups run over stdio, while hosted integrations use Streamable HTTP. Local mode supports switching between several Google profiles per tool call. For shared infrastructure, team mode associates each incoming call with distinct OAuth 2.1 tokens.

The server cannot run without valid Google Cloud credentials configured first. You need to enable the corresponding Workspace APIs, save a Desktop application OAuth credential file, and complete browser login before client tools start responding.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GOOGLE_DRIVE_OAUTH_CREDENTIALS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Google Drive

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add google-drive-mcp -e GOOGLE_DRIVE_OAUTH_CREDENTIALS=<GOOGLE_DRIVE_OAUTH_CREDENTIALS> -- npx -y @piotr-agier/google-drive-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add google-drive-mcp --env GOOGLE_DRIVE_OAUTH_CREDENTIALS=<GOOGLE_DRIVE_OAUTH_CREDENTIALS> -- npx -y @piotr-agier/google-drive-mcp
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GOOGLE_DRIVE_OAUTH_CREDENTIALS=<GOOGLE_DRIVE_OAUTH_CREDENTIALS> google-drive-mcp npx -y @piotr-agier/google-drive-mcp
```
Replace <…> with your own values

## When to use it
- organize and move files across Google Drive folders
- update body text and comments inside Google Docs
- populate tables and format cells in Google Sheets
- schedule Google Calendar meetings with attached documents

## Example prompts
- Run authGetStatus to check which Google account is currently active.
- Search Google Drive for PDF reports from last week and move them to an Archive folder.
- Build a monthly revenue table in Google Sheets and draft an outline in a new Google Doc.

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4259
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1074
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1051
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 777

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