Google Workspace MCP 服务器

本项目基于以下仓库创建： epaproditus/google-workspace-mcp-server

提供 Google Workspace 功能（日历、邮件）作为 MCP 服务器的应用程序

功能

Gmail 功能

• list_emails: 从收件箱中列出带有过滤条件的最近邮件
• search_emails: 使用 Gmail 查询语法进行高级邮件搜索
• send_email: 支持抄送 (CC) 和密送 (BCC) 的邮件发送
• modify_email: 邮件标签管理（存档、垃圾箱、已读/未读）

日历功能

• list_events: 列出指定日期范围内的日程
• create_event: 创建带有参与者的日程
• update_event: 更新现有日程
• delete_event: 删除日程

必要条件

1. Node.js: 安装 Node.js 20 或更高版本
2. Google Cloud Console 设置:
   • 访问 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用 Gmail API 和 Google Calendar API:
     1. 转到 "APIs & Services" > "Library"
     2. 搜索 "Gmail API" 并启用
     3. 搜索 "Google Calendar API" 并启用
   • 设置 OAuth 2.0 凭据:
     1. 转到 "APIs & Services" > "Credentials"
     2. 点击 "Create Credentials" > "OAuth client ID"
     3. 选择 "Desktop application"
     4. 在 "Authorized redirect URIs" 中添加 http://localhost:4100/code
     5. 记录 Client ID 和 Client Secret

设置步骤

1. 克隆和安装仓库:

   git clone https://github.com/Yulikepython/gogole-workspace-mcp-server-by-itc.git
   cd google-workspace-mcp-server-by-itc
   npm install
   

2. 设置凭据:

   # 复制 credentials.json.example
   cp credentials.json.example credentials.json
   

   编辑 credentials.json 如下:

   {
     "web": {
       "client_id": "YOUR_CLIENT_ID",
       "client_secret": "YOUR_CLIENT_SECRET",
       "redirect_uris": ["http://localhost:4100/code"],
       "auth_uri": "https://accounts.google.com/o/oauth2/auth",
       "token_uri": "https://oauth2.googleapis.com/token"
     }
   }
   

3. 获取刷新令牌:

   node get-refresh-token.js
   

   这将会:

   • 打开浏览器并执行 Google OAuth 认证
   • 需要以下权限:
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/calendar
     • https://www.googleapis.com/auth/gmail.send
   • 凭据将保存到 token.json
   • 刷新令牌将显示在控制台中

4. 配置 MCP 设置: 将服务器设置添加到 MCP 配置文件:

   • VSCode Claude 扩展: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Claude 桌面应用: ~/Library/Application Support/Claude/claude_desktop_config.json

   在 mcpServers 对象中添加以下内容:

   {
     "mcpServers": {
       "google-workspace": {
         "command": "node",
         "args": ["/path/to/google-workspace-server/build/index.js"],
         "env": {
           "GOOGLE_CLIENT_ID": "your_client_id",
           "GOOGLE_CLIENT_SECRET": "your_client_secret",
           "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
         }
       }
     }
   }
   

5. 构建和运行:

   npm run build
   

6. 添加部署配置 (.env):

   要使用 deploy 脚本，需要 .env 文件。

   cp .env.example .env
   

   在 .env 中设置以下环境变量:

   SSH_USER=your_ssh_user
   SSH_HOST=your.ssh.host
   SSH_PATH=/your/deploy/path
   

npm scripts

命令	说明
npm run build	创建 bundle 并赋予执行权限
npm run start	在本地构建并运行
npm run clean	删除构建产物
npm run deploy	构建后，将文件部署到生产环境
npm run logs	实时显示生产环境的应用程序日志

使用例

Gmail 操作

1. 最近邮件列表:

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

2. 邮件搜索:

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

3. 邮件发送:

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

4. 邮件标签修改:

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

日历操作

1. 日程列表:

   {
     "maxResults": 10,
     "timeMin": "2024-01-01T00:00:00Z",
     "timeMax": "2024-12-31T23:59:59Z"
   }
   

2. 日程创建:

   {
     "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"]
   }
   

3. 日程更新:

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

4. 日程删除:

   {
     "eventId": "event_id"
   }
   

故障排除

1. 认证问题:

   • 确认已授予所需的 OAuth 范围
   • 确认 Client ID 和 Secret 正确
   • 确认刷新令牌有效

2. API 错误:

   • 在 Google Cloud Console 中检查 API 配额和限制
   • 确认已在项目中启用 API
   • 确认请求参数格式正确

许可证

MIT