Gmail MCP 服务器

一个提供与 Gmail API 交互工具的 Model Context Protocol (MCP) 服务器。此服务器通过 MCP 接口让你能够对电子邮件进行编程管理。

功能

Gmail 工具

• list_emails: 列出收件箱中的近期邮件，支持可选过滤
• search_emails: 使用 Gmail 查询语法的高级邮件搜索
• send_email: 发送新邮件，支持 CC 和 BCC
• 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 应用程序"
     4. 设置 "Authorized redirect URIs" 包括: http://localhost:3001/code
     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. 获取 Refresh Token:

   node get-refresh-token.js
   

   这将：

   • 打开浏览器进行 Google OAuth 认证
   • 请求以下权限：
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/gmail.send
   • 将凭证保存到 token.json
   • 在控制台显示 refresh token

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-mcp-server/index.js"],
         "env": {}
       }
     }
   }
   

5. 运行服务器:

   npm start
   

使用示例

列出邮件

{
  "command": "_gmail.list_emails",
  "args": {
    "userId": "me"
  },
  "response": {
    "data": {
      "messages": []
    }
  }
}

搜索邮件

{
  "command": "_gmail.search_emails",
  "args": {
    "userId": "me",
    "query": "inbox is:unread label:important"
  },
  "response": {
    "data": {
      "messages": []
    }
  }
}

发送邮件

{
  "command": "_gmail.send_email",
  "args": {
    "userId": "me",
    "email": {
      "to": "recipient@example.com",
      "subject": "Test Email",
      "bodyText": "This is a test email."
    }
  },
  "response": {
    "data": {
      "id": "string"
    }
  }
}

修改邮件

{
  "command": "_gmail.modify_email",
  "args": {
    "userId": "me",