Gmail MCP Server 7im

🚀 Gmail MCP 服務器

Gmail MCP 服務器是一個基於 Model Context Protocol (MCP) 的工具，它提供了與 Gmail API 交互的能力。藉助 MCP 接口，用戶可以對電子郵件進行編程管理，極大地提升了郵件管理的效率和靈活性。

🚀 快速開始

Gmail MCP 服務器為用戶提供了便捷的方式來管理 Gmail 郵件。通過 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",
    // 原文檔此處未完整，保持原樣
  }
}