[WIP] Programmable Email

［WIP］プログラマブルメール

Claude を Gmail に接続する MCP サーバー

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

前提条件

• Docker
• Mac 版 Claude Desktop

インストール

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. MCP サーバーを Claude に設定

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 に最近の未読メールを取得するよう依頼する

TODO

• Gmail の読み取り機能を完成させる（現在利用できるのは検索機能の一部のみです。index.ts を参照）
• Gmail の送信機能を MCP ツールとして実装する（利用可能な機能については gmail_api.ts を参照）
• テストを追加する