使用说明
谷歌工作区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.在谷歌云控制台上创建服务帐户
- Google 云控制台 访问
- 选择项目(或新建)
- IAM和管理 > 服务帐户 的双曲正切值
- 创建服务帐户 来修改标记元素的显示属性
- 通过输入名称创建
- 钥匙 在工作空间的边缘 添加密钥 > 创建新密钥 > JSON 列表框中,此格式对应于条目“无”
- 下载JSON文件
2.设置整个域的委托
要使用服务帐户访问用户的数据,需要整个域的委托。
-
在谷歌云控制台中打开已创建的服务帐户
-
显示高级设置 来修改标记元素的显示属性
-
整个域委托 启用
-
唯一标识复制(客户端ID)
-
谷歌管理控制台 访问
-
安全性 > 访问和数据管理 > API控制 的双曲正切值
-
整个域委托 > 管理API客户端 来修改标记元素的显示属性
-
添加新客户端
- 客户端标识:上面复制的标识
- 检查范围(逗号分隔):
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日間の未読メールを確認して
创建任务
「レポート作成」というタスクを追加して、期限は明日
许可证
麻省理工学院