Fastmail MCP-Server (Inoffiziell)

Inoffizieller Model Context Protocol-Server für die Fastmail-Integration. Stellt ein einzelnes execute-Tool bereit, das als validierter JMAP-Proxy fungiert — das LLM schreibt rohe JMAP-Methodenaufrufe, und der Server übernimmt die Validierung, Authentifizierung und Bereinigung der Antworten.

Einrichtungsanleitung

1. API-Token von Fastmail abrufen

1. Melden Sie sich bei Fastmail an

2. Gehen Sie zu Einstellungen → Privatsphäre & Sicherheit → API-Token

3. Klicken Sie auf Neues API-Token

4. Geben Sie ihm einen Namen (z. B. "Claude MCP")

5. Wählen Sie die erforderlichen Bereiche aus: Mail (nach Bedarf lesen/schreiben)

6. Kopieren Sie das generierte Token

2. Claude Code konfigurieren

Fügen Sie Folgendes zu Ihren Claude Code MCP-Einstellungen hinzu (~/.claude/claude_desktop_config.json oder Projekt .mcp.json):

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

Sicherheitshinweis: Bewahren Sie Ihr API-Token sicher auf. Übertragen Sie es niemals in die Versionsverwaltung. Erwägen Sie die Verwendung von Umgebungsvariablen oder eines Secrets-Managers.

Verfügbare Tools

execute

Führt JMAP-Methodenaufrufe gegen Fastmail aus. Akzeptiert ein Array von JMAP-Methodenaufruf-Tripeln [methodName, args, callId].

Eingabe:

{
  "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"]
  ]
}

Was der Server tut:

• Validiert Struktur, Methodennamen und Hygieneregeln

• Fügt accountId automatisch ein

• Sendet an die JMAP-API von Fastmail

• Entfernt Protokollrauschen (state, queryState, canCalculateChanges usw.)

• Gibt bereinigte methodResponses zurück

Zulässige JMAP-Methoden:

• 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

Validierungsregeln:

• Jeder /get-Aufruf (außer Mailbox/get, Identity/get) muss ein properties-Array enthalten

• Jeder /query-Aufruf muss ein limit enthalten

• ids: null bei /get-Aufrufen wird abgelehnt (verwenden Sie zuerst /query)

• Destruktive Operationen (destroy, EmailSubmission/set) geben einen Fehler zurück, der eine Benutzerbestätigung anfordert

compose_email (MCP-App)

Öffnet ein interaktives Formular zum Verfassen von E-Mails. Felder (An, Cc, Bcc, Betreff, Text) können optional vorausgefüllt werden. Auf Hosts, die MCP-Apps unterstützen, wird eine Inline-UI zum Verfassen mit Senden- und Entwurf-speichern-Schaltflächen gerendert. Fällt auf anderen Hosts auf strukturierten Text zurück.

Eingabe:

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

read_email (MCP-App)

Zeigt den vollständigen Inhalt einer E-Mail in einer erweiterten Leseansicht an. Ruft die E-Mail über die JMAP-ID ab und rendert Header, bereinigten Text und Aktionsschaltflächen (Antworten, Allen antworten, Weiterleiten). Fällt auf Hosts ohne Unterstützung für MCP-Apps auf strukturierten Text zurück.

Eingabe:

{
  "emailId": "M1234abcd"
}

Verfügbare Ressourcen

Ressourcenbewusste MCP-Clients erhalten automatisch die Fastmail-Fähigkeit — eine Reihe von Markdown-Dateien, die dem LLM beibringen, wie das execute JMAP-Tool gesteuert wird. Clients, die Ressourcenpriorität unterstützen, laden SKILL.md zuerst und folgen den Links bei Bedarf.

Alle Ressourcen verwenden das URI-Schema file:///fastmail-skill/<path> und den MIME-Typ text/markdown. Getaggt mit audience: ["assistant"].

API-Endpunkte

• POST /mcp - MCP-Protokoll-Endpunkt

• GET /health - Gesundheits-Check-Endpunkt

Umgebungsvariablen

Kopieren Sie .env.example nach .env.development.local und füllen Sie die Werte aus:

cp .env.example .env.development.local

Entwicklung

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

Dies ist ein inoffizielles Community-Projekt und steht in keiner Verbindung zu Fastmail.

Quellcode und Probleme: GitHub