Gmail MCP 服务器

Gmail MCP 服务器

一个支持 Claude 桌面应用与 Gmail 交互的 Model Context Protocol (MCP) 服务器。

快速入门

前置条件

  • 安装 Node.js 16 或更高版本
  • 安装 npm

安装步骤

  1. 创建 Google Cloud 项目并启用 Gmail API

    • 访问 Google Cloud Console
    • 创建新项目
    • 启用 Gmail API
    • 创建 OAuth 凭据(桌面应用)
    • 下载凭据文件并保存为 gcp-oauth.keys.json
  2. 克隆和安装依赖

    git clone https://github.com/cristip73/MCP-email-server.git
    cd MCP-email-server
    npm install
    
  3. 构建服务器

    npm run build
    
  4. 进行 Gmail 身份验证

    npm run auth
    
  5. 将包链接到系统

    npm link
    

使用方法

在 Claude Desktop 中配置:

  • 修改开发者模式下的 JSON 配置文件,添加 email-server

示例配置:

{
  "mcpServers": {
    "email-server": {
      "command": "node",
      "args": ["/path/to/email-server/build/index.js"],
      "env": {
        "TIME_ZONE": "GMT+2",
        "DEFAULT_ATTACHMENTS_FOLDER": "/Users/username/CLAUDE/Attachments"
      }
    }
  }
}

设置时区和附件路径以确保功能正常。