Headless Gmail MCP Server

Máy chủ “Headless Gmail” MCP làm gì?

Headless Gmail MCP Server là một máy chủ Model Context Protocol (MCP) cho phép tương tác liền mạch với các tài khoản Gmail để gửi và nhận email mà không cần thiết lập token hoặc thông tin xác thực cục bộ. Được thiết kế để vận hành không giao diện và từ xa, nó cho phép các client hoàn tất quy trình OAuth một cách độc lập và truyền thông tin xác thực an toàn qua context, giúp triển khai trên môi trường container hoặc đám mây hoàn toàn mà không cần truy cập file cục bộ hoặc trình duyệt. Máy chủ này rất phù hợp cho các luồng công việc cần truy cập Gmail chuyên biệt, tin cậy—như tự động hóa marketing hoặc hệ thống thông báo—bằng cách cung cấp các công cụ chuẩn hóa qua giao diện MCP cho quản lý email và tích hợp vào các pipeline phát triển AI.

Danh sách Prompt

Không có prompt template cụ thể nào được đề cập trong repository.

Danh sách Resource

Không có MCP resource rõ ràng nào được mô tả trong tài liệu hoặc mã nguồn.

Danh sách Công cụ

• Lấy email gần đây
  Lấy các email mới nhất từ tài khoản Gmail, trả về tối đa 1.000 ký tự đầu tiên của nội dung email.
• Lấy toàn bộ nội dung email
  Truy xuất toàn bộ nội dung một email theo từng phần 1.000 ký tự thông qua tham số offset, cho phép lấy email dung lượng lớn.
• Gửi email
  Gửi email qua tài khoản Gmail đã kết nối.
• Làm mới token truy cập
  Tự động làm mới token, đảm bảo truy cập an toàn liên tục.

Các trường hợp sử dụng MCP Server này

• Thông báo Email Tự động
  Tích hợp với agent AI hoặc nền tảng tự động hóa để gửi thông báo email theo thời gian thực mà không cần thao tác thủ công.
• Giám sát Hộp Thư Đến Gmail
  Lấy và xử lý email mới nhất để tự động phản hồi, phân loại hoặc trích xuất thông tin cho các quy trình tiếp theo.
• Tự động hóa Chiến dịch Marketing
  Gửi email marketing cá nhân hóa bằng lập trình, sử dụng MCP để thực hiện chiến dịch quy mô lớn và tách biệt thông tin xác thực.
• Tích hợp API liền mạch
  Nhúng thao tác Gmail vào môi trường phát triển hoặc nền tảng hỗ trợ MCP khác mà không phải lộ hoặc quản lý thông tin xác thực cục bộ.
• Quản lý Email từ xa/đám mây
  Quản lý tài khoản Gmail trong môi trường Docker hoặc thiết lập từ xa, cho phép vận hành an toàn, không giao diện mà không phụ thuộc cục bộ.

Thiết lập như thế nào

Windsurf

1. Đảm bảo bạn đã cài đặt Node.js và Windsurf.
2. Mở file cấu hình (ví dụ: windsurf.json).
3. Thêm Headless Gmail MCP Server vào phần mcpServers:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Lưu lại và khởi động lại Windsurf.
5. Xác nhận máy chủ hoạt động trên dashboard của Windsurf.

Bảo mật API Keys
Sử dụng biến môi trường để truyền thông tin xác thực an toàn:

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": ["@baryhuang/mcp-headless-gmail@latest"],
      "env": {
        "GMAIL_CLIENT_ID": "...",
        "GMAIL_CLIENT_SECRET": "...",
        "GMAIL_ACCESS_TOKEN": "...",
        "GMAIL_REFRESH_TOKEN": "..."
      }
    }
  }
}

Claude

1. Cài đặt Claude và đảm bảo Node.js đã có sẵn.
2. Sửa file cấu hình (ví dụ: claude.json).
3. Thêm máy chủ:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Lưu lại và khởi động lại Claude.
5. Kiểm tra trạng thái máy chủ từ giao diện Claude.

Bảo mật API Keys
Sử dụng khóa env như trên để truyền thông tin xác thực an toàn.

Cursor

1. Đảm bảo Cursor đã được cài đặt và cập nhật.
2. Mở phần cài đặt hoặc file cấu hình của Cursor.
3. Thêm mục MCP server:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Xác nhận MCP server đã được nhận diện.

Bảo mật API Keys
Cấu hình thông tin xác thực với phần env như đã hướng dẫn.

Cline

1. Cài đặt Cline và các phụ thuộc.
2. Mở file cấu hình Cline.
3. Thêm MCP server:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Lưu lại, sau đó khởi động lại Cline.
5. Đảm bảo máy chủ kết nối qua các công cụ của Cline.

Bảo mật API Keys
Truyền thông tin xác thực API bằng biến môi trường trong cấu hình như các ví dụ trước.

Sử dụng MCP này trong luồng công việc

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào luồng công việc FlowHunt, bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với agent AI của bạn:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, nhập thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "headless-gmail": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, agent AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Lưu ý đổi “headless-gmail” thành tên thực tế của MCP server bạn dùng (ví dụ “github-mcp”, “weather-api”, v.v.) và thay URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

Đánh giá của chúng tôi

Dựa trên thông tin hiện có, Headless Gmail MCP Server tập trung mạnh vào độ chuyên biệt và dễ tích hợp, với hướng dẫn rõ ràng cho hầu hết các nền tảng và hỗ trợ tốt cho Docker/headless. Tuy nhiên, máy chủ này thiếu các prompt template và định nghĩa resource rõ ràng, có thể hạn chế một số tính năng MCP nâng cao. Thế mạnh của nó là đơn giản, bảo mật và hữu ích thực tế cho tự động hóa email. Tổng thể, đây là giải pháp thực tiễn, đáng tin cậy cho mục đích sử dụng của nó, dù chưa đầy đủ tính năng như một số máy chủ MCP khác.

Điểm MCP