Programmable Email

🚀 [可編程電子郵件]

本項目是用於連接Claude與Gmail的MCP服務器，藉助Gmail的本地OAuth令牌實現二者相連。該服務器主要用於實驗和測試，不過要注意，獲取的所有郵件都會發送到Claude的服務器。

🚀 快速開始

此服務器將Claude（或任何MCP客戶端）與Gmail相連接，利用Gmail的本地OAuth令牌進行操作。它專為實驗和測試而設計，使用時獲取的所有郵件都會被髮送到Claude的服務器。

📦 安裝指南

1. Gmail OAuth憑證

首先，您需要生成個人OAuth令牌。請按照此指南進行操作，創建一個服務器端應用的OAuth客戶端ID憑證。

您需要在根目錄準備好兩個文件，一個是代表Google的OAuth令牌的credentials.json文件，另一個是token.json。token.json會在首次使用Google OAuth憑證時自動生成。

2. 運行docker build

通過運行以下命令構建鏡像：

docker build -t programmable-email .

確認其是否正常運行，可使用以下命令：

docker run -i --rm programmable-email

3. 配置Claude以連接MCP服務器

訪問MCP服務器配置所在的目錄：

cd ~/Library/Application\ Support/Claude

編輯claude_desktop_config.json文件，添加以下內容：

{
    "mcpServers": {
        "programmable-email": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "programmable-email"]
        }
    }
}

4. 打開（或重啟）Claude

5. 讓Claude獲取您最近的未讀郵件。

📋 待辦事項

• 完成Gmail閱讀功能（目前僅實現了部分可用搜索功能，見index.ts）
• 實現Gmail發送功能（參見gmail_api.ts中的能力）
• 進行更多測試