使用说明
@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-见 许可证