AI导哈

GSuite MCP 服务器

一个将AI连接到Gmail、Google日历、联系人和任务的MCP服务器。

  • by 2389-research
  • Go
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 2389-research/gsuite-mcp

使用说明

GSuite MCP服务器

一个MCP服务器，将您的AI连接到Gmail、谷歌日历、联系人和任务。

安装

brew install 2389-research/tap/gsuite-mcp

或者从源代码构建：

go build ./cmd/gsuite-mcp

设置

1.创建Google OAuth凭据

  1. 首选 谷歌云控制台
  2. 创建项目（或选择现有项目）
  3. 点击 +创建凭据 > OAuth客户端ID > 桌面应用程序
  4. 下载JSON并保存到 ~/.config/gsuite-mcp/credentials.json

2.启用API

在每个选项上单击“启用”：

3.身份验证

gsuite-mcp setup

这将打印一个谷歌登录链接。打开它，批准访问，并将代码粘贴回终端。令牌保存在本地，因此您只需执行一次。

4.连接到您的AI客户端

克劳德代码：

claude mcp add gsuite gsuite-mcp -- mcp    # project scope (default)
claude mcp add gsuite gsuite-mcp --scope user -- mcp   # user scope (all projects)

对于Claude Desktop或其他MCP客户端，请将以下内容添加到您的配置中：

{
  "mcpServers": {
    "gsuite": {
      "command": "gsuite-mcp",
      "args": ["mcp"]
    }
  }
}

完成。您的AI现在可以与您的Google帐户一起工作。

多个账户

您可以连接多个Google帐户：

gsuite-mcp setup --account work
gsuite-mcp setup --account personal

然后告诉你的AI是哪一个：

“检查我的 工作 如有紧急情况，请发送电子邮件 “我身上有什么 个人的 本周的日历？"

每个工具都接受一个可选 account 参数。如果没有，则使用默认值。

$ gsuite-mcp whoami --account work
Account:  work
Email:    harper@2389.ai
Messages: 4210 total
Threads:  1847 total

它能做什么

四个谷歌API中的34个工具，以及提示和实时数据。

Gmail --阅读、搜索、发送、草稿、标签、垃圾箱、删除。支持CC/BCC。

日历 --列出、查看、创建、更新和删除事件。

联系人 --搜索、浏览、创建、更新、删除。

任务 --管理任务列表和任务（创建、更新、完成、删除）。

该服务器还附带了常见工作流的提示：分类电子邮件、使用适当的线程编写回复、根据您的可用性安排会议、查看待处理的任务、将目标分解到任务列表中，以及查找或添加联系人。你的AI会自动拾取这些。

为了快速上下文，服务器将实时数据作为MCP资源公开：今天的日历、即将发生的事件、未读邮件、当前草稿、今天到期的任务、逾期任务等。

安全

代币在您的机器上运行 ~/.local/share/gsuite-mcp/什么都不会离开你的电脑。服务器只请求它需要的OAuth作用域。保持 credentials.json 以及git之外的令牌文件。

CLI参考

gsuite-mcp setup                   # Interactive setup wizard
gsuite-mcp setup --account work    # Set up a named account
gsuite-mcp test                    # Test your API connection
gsuite-mcp whoami                  # Show authenticated user
gsuite-mcp mcp                     # Start the MCP server
gsuite-mcp version                 # Show version
gsuite-mcp help                    # Show help

文档

看 docs/ 有关详细指南：

  • 设置 --逐步设置
  • 用法 --完整的工具参考和示例
  • ISH模式 --使用本地模拟服务器进行测试

贡献

  1. 分叉回购
  2. 创建分支
  3. 编写测试
  4. go test ./...
  5. 打开PR

许可证

麻省理工学院

相关 MCP