Google Workspace MCP服务器

Google Workspace MCP服务器是一个用于访问Google Workspace(日历、Gmail、Drive、任务)的中间件,可在Vercel上部署使用。

  • by nocall-corp
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 nocall-corp/google-workspace-mcp

使用说明

谷歌工作区MCP服务器

它是一个MCP服务器,用于访问谷歌Workspace(Calendar,Gmail,Drive,Tasks)。 部署并用于验证。

机能

日历

  • google_calendar_list_events -获取事件列表
  • google_calendar_get_event -获取事件详细信息
  • google_calendar_create_event -创建事件
  • google_calendar_update_event -事件更新
  • google_calendar_delete_event -删除事件
  • google_calendar_list_calendars -获取日历列表

Gmail

  • google_gmail_search -邮件搜索
  • google_gmail_get_message -获取邮件详细信息
  • google_gmail_send -发送电子邮件
  • google_gmail_list_labels -标签列表
  • google_gmail_modify_labels -更改标签

驾驶

  • google_drive_list -文件列表
  • google_drive_search -文件搜索
  • google_drive_get_file -获取文件详细信息
  • google_drive_get_content -获取文件内容

任务

  • google_tasks_list_tasklists -任务列表
  • google_tasks_list -任务列表
  • google_tasks_create -创建任务
  • google_tasks_update -任务更新
  • google_tasks_complete -任务完成
  • google_tasks_delete -删除任务

安装,安装

1.在谷歌云控制台上创建服务帐户

  1. Google 云控制台 访问
  2. 选择项目(或新建)
  3. IAM和管理 > 服务帐户 的双曲正切值
  4. 创建服务帐户 来修改标记元素的显示属性
  5. 通过输入名称创建
  6. 钥匙 在工作空间的边缘 添加密钥 > 创建新密钥 > JSON 列表框中,此格式对应于条目“无”
  7. 下载JSON文件

2.设置整个域的委托

要使用服务帐户访问用户的数据,需要整个域的委托。

  1. 在谷歌云控制台中打开已创建的服务帐户

  2. 显示高级设置 来修改标记元素的显示属性

  3. 整个域委托 启用

  4. 唯一标识复制(客户端ID)

  5. 谷歌管理控制台 访问

  6. 安全性 > 访问和数据管理 > API控制 的双曲正切值

  7. 整个域委托 > 管理API客户端 来修改标记元素的显示属性

  8. 添加新客户端

    • 客户端标识:上面复制的标识
    • 检查范围(逗号分隔):
      https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/gmail.modify,https://www.googleapis.com/auth/gmail.send,https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/tasks
      

3.部署到Vercel

# リポジトリをクローン
cd /Users/shogohayashi/dev/google-workspace-mcp

# 依存関係をインストール
npm install

# Vercel にデプロイ
vercel

# 本番デプロイ
vercel --prod

4.设置环境变量

在“验证”操控板上设置以下环境变量:

变数名 说明
GOOGLE_SERVICE_ACCOUNT_KEY |服务帐户的JSON密钥(整形为1行)|
GOOGLE_DELEGATED_USER |受委托用户的电子邮件地址(例如:hayashi@nocall.ai)
MCP_AUTH_TOKEN MCP认证令牌(任意字符串)

GOOGLE_SERVICE_ACCOUNT_KEYの设定方法:

# JSON を 1 行に変換
cat service-account-key.json | jq -c .

请将输出的字符串设置为环境变量。

5.添加到mcp.json

{
  "mcpServers": {
    "google-workspace": {
      "url": "https://google-workspace-mcp.vercel.app/mcp",
      "headers": {
        "Authorization": "Bearer ${GOOGLE_WORKSPACE_MCP_AUTH_TOKEN}"
      }
    }
  }
}

使用例

获取日历约会

今日の予定を教えて

搜索邮件

過去7日間の未読メールを確認して

创建任务

「レポート作成」というタスクを追加して、期限は明日

许可证

麻省理工学院