Gmail MCP Server

Gmail MCP Server

一种用于与 Gmail API 交互的模型上下文协议（MCP）服务，提供相关工具。此服务让你能够通过 MCP 接口以编程方式管理电子邮件。

功能

Gmail 工具

• list_emails：列出收件箱中的近期电子邮件，可选筛选条件
• search_emails：使用 Gmail 查询语法进行高级电子邮件搜索
• send_email：发送新电子邮件，支持抄送和密送
• modify_email：修改电子邮件标签（归档、移至垃圾箱、标记为已读／未读）

前提条件

1. Node.js：安装 Node.js 14 或更高版本
2. Google Cloud Console 设置：
   • 前往 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用 Gmail API：
     1. 前往“APIs & Services” > “Library”
     2. 搜索并启用“Gmail API”
   • 设置 OAuth 2.0 凭据：
     1. 前往“APIs & Services” > “Credentials”
     2. 点击“Create Credentials” > “OAuth client ID”
     3. 选择“Web application”
     4. 将 http://localhost:3001/code 添加到“Authorized redirect URIs”
     5. 记下 Client ID 和 Client Secret

设置说明

1. 克隆并安装：

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

2. 创建 OAuth 凭据： 在根目录中创建 credentials.json 文件：

   {
       "web": {
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET",
           "redirect_uris": ["http://localhost:3001/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/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-gmail": {
         "command": "node",
         "args": ["/path/to/google-gmail-server/build/index.js"],
         "env": {
           "GOOGLE_ACCESS_TOKEN": "your_access_token",
         }
       }
     }
   }
   

5. 构建并运行：

   npm run build
   

使用示例

Gmail 操作

1. 列出近期电子邮件：

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

2. 搜索电子邮件：

   {
     "query": "from:[email protected] has:attachment",
     "maxResults": 10
   }
   

3. 发送电子邮件：

   {
     "to": "[email protected]",
     "subject": "Hello",
     "body": "Message content",
     "cc": "[email protected]",
     "bcc": "[email protected]"
   }
   

4. 修改电子邮件：

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

许可证

MIT