Google Workspace MCP服务器

NPM可分发的Google Workspace MCP服务器,用于Claude Desktop、Claude Code CLI和其他MCP客户端,通过Claude与Gmail、日历、Drive、Docs、Sheets、Chat等服务交互。

  • by jrenaldi79
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 jrenaldi79/google-workspace-mcp

使用说明

@prestoai/googleworkspacemcp

适用于Claude Desktop、Claude Code CLI和其他MCP客户端的NPM可分发Google Workspace MCP服务器。通过Claude与Gmail、日历、驱动器、文档、表格、聊天等进行交互。

基于 gemini cli扩展/工作区.

快速开始

配置您的MCP客户端

克劳德桌面版

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["-y", "@presto-ai/google-workspace-mcp"]
    }
  }
}

然后重新启动Claude Desktop。MCP服务器将在首次使用时提示进行身份验证。

克劳德代码CLI

编辑 ~/.claude/config.json:

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["-y", "@presto-ai/google-workspace-mcp"]
    }
  }
}

支持服务列表

  • Gmail:搜索电子邮件、阅读消息、发送电子邮件、创建/管理草稿
  • 谷歌日历:列出日历,创建/读取/更新/删除事件,查找空闲时间
  • Google 云端硬盘:搜索文件、下载文档、访问元数据
  • 谷歌文档:读取文档内容、创建文档、插入/替换文本
  • 谷歌表格:读取电子表格范围、获取元数据、附加数据
  • 谷歌聊天:发送消息、读取线程、创建空间
  • 谷歌幻灯片:阅读演示文稿、提取文本、获取元数据
  • 谷歌人:获取用户资料,检索联系信息

配置

环境变量

# Override credential storage location (optional)
export GOOGLE_WORKSPACE_MCP_HOME=/custom/path/for/credentials

凭据存储

凭据存储在平台标准位置:

平台 位置
macOS ~/.config/google-workspace-mcp/
Linux ~/.config/google-workspace-mcp/
窗户 %APPDATA%/google-workspace-mcp/

需求

  • Node.js 18或更高版本
  • 具有Google工作区访问权限的活动Google帐户
  • 用于OAuth身份验证的Web浏览器

故障排除

令牌刷新错误

删除凭据并重新启动:

rm -rf ~/.config/google-workspace-mcp  # macOS/Linux
npx @presto-ai/google-workspace-mcp    # Will prompt for re-auth

Linux上的“libsecret”错误

sudo apt-get install libsecret-1-dev  # Debian/Ubuntu
sudo dnf install libsecret-devel      # Fedora/RHEL

许可证

Apache-2.0-见 许可证