Google Workspace MCP 服务器

一个模型上下文协议（MCP）服务器，提供与 Gmail 和 Calendar API 交互的工具。此服务器使您能够通过 MCP 接口以编程方式管理您的电子邮件和日历事件。

功能

Gmail 工具

• list_emails: 列出收件箱中的最近邮件，可选过滤
• search_emails: 使用 Gmail 查询语法进行高级邮件搜索
• send_email: 发送新邮件，支持抄送和密送
• modify_email: 修改邮件标签（归档、删除、标记为已读/未读）

日历工具

• list_events: 列出即将发生的日历事件，支持日期范围过滤
• create_event: 创建新的日历事件，支持添加参与者
• update_event: 更新现有的日历事件
• delete_event: 删除日历事件

用户工具

• list_contacts: 列出来自 Google 联系人的联系人
• get_user_info: 获取用户信息

前提条件

1. Node.js: 安装 Node.js 版本 14 或更高
2. Google API 访问令牌: 您需要一个有效的访问令牌来验证与 Google API 的连接

设置说明

1. 克隆和安装：

   git clone https://github.com/yourusername/google-workspace-mcp-server.git
   cd google-workspace-mcp-server
   npm install
   

2. 构建和运行：

   npm run build
   

使用示例

所有操作都需要一个有效的 accessToken 参数。此令牌必须具有您要执行的操作所需的适当 OAuth 权限。

Gmail 操作

1. 列出最近的邮件：

   {
     "accessToken": "your_access_token",
     "maxResults": 5,
     "query": "is:unread"
   }
   

2. 搜索邮件：

   {
     "accessToken": "your_access_token",
     "query": "from:example@gmail.com has:attachment",
     "maxResults": 10
   }
   

3. 发送邮件：

   {
     "accessToken": "your_access_token",
     "to": "recipient@example.com",
     "subject": "Hello",
     "body": "Message content",
     "cc": "cc@example.com",
     "bcc": "bcc@example.com"
   }
   

4. 修改邮件：

   {
     "accessToken": "your_access_token",
     "id": "message_id",
     "addLabels": ["UNREAD"],
     "removeLabels": ["INBOX"]
   }
   

日历操作

1. 列出事件：

   {
     "accessToken": "your_access_token",
     "maxResults": 10,
     "daysBack": 7,
     "daysForward": 30
   }
   

2. 创建事件：

   {
     "accessToken": "your_access_token",
     "summary": "Team Meeting",
     "location": "Conference Room",
     "description": "Weekly sync-up",
     "start": "2024-01-24T10:00:00Z",
     "end": "2024-01-24T11:00:00Z",
     "attendees": ["colleague@example.com"],
     "includeGoogleMeetDetails": true
   }
   

3. 更新事件：

   {
     "accessToken": "your_access_token",
     "eventId": "event_id",
     "summary": "Updated Meeting Title",
     "location": "Virtual",
     "start": "2024-01-24T11:00:00Z",
     "end": "2024-01-24T12:00:00Z"
   }
   

4. 删除事件：

   {
     "accessToken": "your_access_token",
     "eventId": "event_id"
   }
   

用户操作

1. 列出联系人：

   {
     "accessToken": "your_access_token"
   }
   

2. 获取用户信息：

   {
     "accessToken": "your_access_token"
   }
   

项目结构

该项目采用模块化结构组织：

• src/index.ts: 主入口点
• src/server.ts: 设置请求处理程序的服务器类
• src/tools/definitions.ts: MCP 接口的工具定义
• src/handlers/email.ts: Gmail 操作的处理程序
• src/handlers/calendar.ts: 日历操作的处理程序
• src/handlers/user.ts: 用户和联系人操作的处理程序

许可证

本项目采用 MIT 许可证。