Programmable Email

🚀 プログラマブルな電子メール

このプロジェクトは、ClaudeとGmailを接続するMCPサーバーです。このサーバーは、GmailのローカルOAuthトークンを使用して、Claude（または任意のMCPクライアント）とGmailを接続します。このサーバーは、実験およびテスト目的で設計されています。取得したすべてのメールはClaudeのサーバーに送信されることに注意してください。

🚀 クイックスタート

このサーバーはClaude（または任意のMCPクライアント）とGmailを接続し、GmailのローカルOAuthトークンを利用します。主に実験とテストを目的としていますが、取得した全てのメールはClaudeのサーバーに送信されます。

📦 インストール

前提条件

• Docker
• Mac版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の機能を参照）
• より多くのテストを行う