Fastmail MCPサーバー (非公式)

Fastmail統合のための非公式Model Context Protocolサーバーです。検証済みのJMAPプロキシとして機能する単一の execute ツールを公開します。LLMが生のJMAPメソッド呼び出しを記述し、サーバーが検証、認証、レスポンスのクリーニングを処理します。

セットアップ手順

1. Fastmail APIトークンの取得

1. Fastmail にログインします

2. Settings → Privacy & Security → API tokens に移動します

3. New API token をクリックします

4. 名前を付けます（例: "Claude MCP"）

5. 必要なスコープを選択します: Mail (必要に応じて読み取り/書き込み)

6. 生成されたトークンをコピーします

2. Claude Codeの設定

Claude CodeのMCP設定（~/.claude/claude_desktop_config.json またはプロジェクトの .mcp.json）に以下を追加します:

{
  "mcpServers": {
    "fastmail": {
      "type": "url",
      "url": "https://fastmail-mcp.i11v.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

セキュリティ上の注意: APIトークンは安全に保管してください。バージョン管理システムには絶対にコミットしないでください。環境変数やシークレットマネージャーの使用を検討してください。

利用可能なツール

execute

Fastmailに対してJMAPメソッド呼び出しを実行します。JMAPメソッド呼び出しのトリプル [methodName, args, callId] の配列を受け取ります。

入力:

{
  "methodCalls": [
    ["Email/query", {
      "filter": { "inMailbox": "INBOX_ID" },
      "sort": [{ "property": "receivedAt", "isAscending": false }],
      "limit": 10
    }, "call-0"],
    ["Email/get", {
      "ids": { "resultOf": "call-0", "name": "Email/query", "path": "/ids" },
      "properties": ["from", "subject", "receivedAt", "preview"]
    }, "call-1"]
  ]
}

サーバーの動作:

• 構造、メソッド名、および衛生ルールの検証

• accountId の自動注入

• FastmailのJMAP APIへの送信

• プロトコルノイズ（state、queryState、canCalculateChanges など）の除去

• クリーンアップされた methodResponses の返却

許可されているJMAPメソッド:

• Core/echo

• Mailbox/get, Mailbox/query, Mailbox/queryChanges, Mailbox/set

• Email/get, Email/query, Email/queryChanges, Email/set

• Thread/get

• SearchSnippet/get

• Identity/get

• EmailSubmission/get, EmailSubmission/query, EmailSubmission/set

検証ルール:

• すべての /get 呼び出し（Mailbox/get、Identity/get を除く）には properties 配列を含める必要があります

• すべての /query 呼び出しには limit を含める必要があります

• /get 呼び出しでの ids: null は拒否されます（先に /query を使用してください）

• 破壊的な操作（destroy、EmailSubmission/set）は、ユーザーの確認を求めるエラーを返します

compose_email (MCPアプリ)

インタラクティブなメール作成フォームを開きます。オプションでフィールド（宛先、CC、BCC、件名、本文）を事前入力できます。MCPアプリをサポートするホストでは、送信および下書き保存ボタンを備えたインライン作成UIをレンダリングします。その他のホストでは構造化テキストにフォールバックします。

入力:

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message text..."
}

read_email (MCPアプリ)

リッチなリーダービューでメールの全内容を表示します。JMAP IDでメールを取得し、ヘッダー、サニタイズされた本文、アクションボタン（返信、全員に返信、転送）をレンダリングします。MCPアプリのサポートがないホストでは構造化テキストにフォールバックします。

入力:

{
  "emailId": "M1234abcd"
}

利用可能なリソース

リソース対応のMCPクライアントは、Fastmailスキルを自動的に受け取ります。これは、execute JMAPツールの操作方法をLLMに教える一連のMarkdownファイルです。リソースの優先順位をサポートするクライアントは、SKILL.md を最初に読み込み、そのリンクを遅延して追跡します。

すべてのリソースは file:///fastmail-skill/<path> URIスキームと text/markdown MIMEタイプを使用します。タグは audience: ["assistant"] です。

APIエンドポイント

• POST /mcp - MCPプロトコルエンドポイント

• GET /health - ヘルスチェックエンドポイント

環境変数

.env.example を .env.development.local にコピーし、値を入力してください:

cp .env.example .env.development.local

開発

pnpm install   # Install dependencies
pnpm dev       # Run local dev server (wrangler)
pnpm check     # Run all checks (typecheck + lint + fmt + test)
pnpm run deploy:prod  # Deploy to Cloudflare

これは非公式のコミュニティプロジェクトであり、Fastmailとは提携していません。

ソースコードと課題: GitHub