将Claude桌面、光标或任何MCP客户端连接到您的Google Docs、Google Sheets、Google Drive、Gmail和Google Calendar。

---

快速启动

1.创建 Google Cloud OAuth 客户端

1. 进入谷歌云控制台
2. 创建或选择项目
3. 启用Google Docs API、Google Sheets API、Google Drive API、Gmail API 和Google Calendar API
4. 配置OAuth同意界面（外部，将你的邮箱添加为测试用户，并将gmail.modify和calendar.events范围与文档/表格/驱动器范围一起添加）
5. 创建OAuth客户端ID（桌面应用类型）
6. 从确认界面复制客户端ID和客户端秘密

需要更多细节吗？请参见本页底部的逐步说明。

2.授权

这会打开你的浏览器进行 Google 授权。批准后，刷新令牌会保存到 ~/.config/google-docs-mcp/token.json。

3.添加到您的MCP客户端

Claude桌面 / 光标 / 风帆冲浪：

当你的MCP客户端需要服务器时，服务器会自动启动。

远程部署（云运行）

只需为团队部署一次——无需本地安装。服务器使用 MCP OAuth 2。

Google Docs, Sheets, Drive, Gmail & Calendar MCP Server

Connect Claude Desktop, Cursor, or any MCP client to your Google Docs, Google Sheets, Google Drive, Gmail, and Google Calendar.

---

Quick Start

1. Create a Google Cloud OAuth Client

1. Go to the Google Cloud Console
2. Create or select a project
3. Enable the Google Docs API, Google Sheets API, Google Drive API, Gmail API, and Google Calendar API
4. Configure the OAuth consent screen (External, add your email as a test user, and add the gmail.modify and calendar.events scopes alongside the Docs/Sheets/Drive scopes)
5. Create an OAuth client ID (Desktop app type)
6. Copy the Client ID and Client Secret from the confirmation screen

Need more detail? See step-by-step instructions at the bottom of this page.

2. Authorize

GOOGLE_CLIENT_ID="your-client-id" \
GOOGLE_CLIENT_SECRET="your-client-secret" \
npx -y @a-bonus/google-docs-mcp auth

This opens your browser for Google authorization. After you approve, the refresh token is saved to ~/.config/google-docs-mcp/token.json.

3. Add to Your MCP Client

Claude Desktop / Cursor / Windsurf:

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

The server starts automatically when your MCP client needs it.

Remote Deployment (Cloud Run)

Deploy once for your team – no local installs required. The server uses MCP OAuth 2.1 so your MCP client handles authentication automatically.

gcloud run deploy google-docs-mcp \
  --source . \
  --region europe-west3 \
  --port 8080 \
  --allow-unauthenticated \
  --set-env-vars "^|^MCP_TRANSPORT=httpStream|BASE_URL=https://your-service.run.app|GOOGLE_CLIENT_ID=...|GOOGLE_CLIENT_SECRET=...|TOKEN_STORE=firestore|JWT_SIGNING_KEY=your-secret-key"

Then each user just adds the URL to their MCP client – no npx, no tokens, no local setup:

{
  "mcpServers": {
    "google-docs": {
      "type": "streamableHttp",
      "url": "https://your-service.run.app/mcp"
    }
  }
}

Your MCP client will prompt for Google sign-in on first connection. See Remote Deployment for details.

---

What Can It Do?

Tools across Google Docs, Sheets, and Drive:

Google Docs