Google服务连接器

用于连接Claude Desktop与Google Mail、Docs、Sheets和Tasks的服务工具。

  • by nosferatu-concorde
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 nosferatu-concorde/claude-google-mcp

使用说明

谷歌MCP服务器

MCP服务器,用于将克劳德桌面连接到谷歌邮件、文档、表格和任务。

设置

1.谷歌云控制台设置

  1. 首选 谷歌云控制台
  2. 创建新项目(或选择现有项目)
  3. 启用这些API(API和服务→ 图书馆):
    • Gmail API
    • 谷歌文档API
    • 谷歌网页API
    • 谷歌任务API
  4. 配置OAuth同意屏幕:
    • 转到API和服务→ OAuth 授权界面
    • 选择“外部”用户类型
    • 填写应用程序名称和电子邮件
    • 添加作用域: gmail.modify, documents, spreadsheets, tasks
    • 将您的电子邮件添加为测试用户
  5. 创建OAuth凭据:
    • 转到API和服务→ 凭证
    • 点击“创建凭据”→ “OAuth客户端ID”
    • 选择“桌面应用程序”作为应用程序类型
    • 下载JSON文件

2.安装和配置

# Install dependencies
npm install

# Build the project
npm run build

# Create config directory and save credentials
mkdir -p ~/.google-mcp
# Save your downloaded credentials.json to ~/.google-mcp/credentials.json

# Authenticate with Google
npm run auth

3.克劳德桌面配置

带WSL的Windows

添加到您的Claude桌面配置(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "google": {
      "command": "wsl",
      "args": [
        "/path/to/node",
        "/path/to/google-mcp-server/dist/index.js"
      ]
    }
  }
}

注: 使用节点的完整路径(运行 which node 在WSL中找到它)。, /home/user/.nvm/versions/node/v22.21.1/bin/node

Linux

增添 ~/.config/claude-desktop/claude_desktop_config.json:

{
  "mcpServers": {
    "google": {
      "command": "node",
      "args": [
        "/path/to/google-mcp-server/dist/index.js"
      ]
    }
  }
}

macOS

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google": {
      "command": "node",
      "args": ["/path/to/google-mcp-server/dist/index.js"]
    }
  }
}

可用工具

Gmail

  • gmail_search -使用Gmail查询语法搜索电子邮件
  • gmail_read -按ID阅读特定电子邮件
  • gmail_send -发送电子邮件

谷歌文档

  • docs_get -获取文档内容
  • docs_create -创建新文档
  • docs_append -在文档中添加文本

谷歌表格

  • sheets_read -从某个范围读取数据
  • sheets_write -将数据写入范围
  • sheets_create -创建新的电子表格

工作表

  • tasks_list -列出任务列表或任务
  • tasks_create -创建新任务
  • tasks_update -更新/完成任务

使用示例

设置后,您可以要求Claude Desktop:

  • “在我的电子邮件中搜索来自的消息john@example.com"
  • “阅读我最近未读的电子邮件”
  • “创建一个名为“会议笔记”的新谷歌文档”
  • “从我的电子表格中读取数据”
  • “显示我的任务列表”
  • “创建一个任务,明天给牙医打电话”