WorkMail MCP-Server

Ein Model Context Protocol (MCP)-Server, der Claude Desktop mit Amazon WorkMail verbindet und E-Mail- sowie Kalenderzugriff über einen sicheren lokalen stdio-Transport bereitstellt.

Funktionen

Related MCP server: Gmail & Calendar Multi-Account MCP Server

Sicherheit

• Anmeldedaten werden im macOS-Schlüsselbund gespeichert (hardwareverschlüsselt auf Apple Silicon) – niemals in Konfigurationsdateien oder Umgebungsvariablen

• Transport verwendet stdio (lokale Pipe) – kein HTTP-Server, keine offenen Ports

• Leitungsverschlüsselung via HTTPS/TLS zum WorkMail EWS-Endpunkt

• Eingabevalidierung bei jedem Tool-Aufruf über Zod-Schemas

• Ausgabesanitisierung entfernt Anmeldedaten aus allen Antworten und Fehlermeldungen

• Ratenbegrenzung verhindert unkontrollierte Anforderungsschleifen (konfigurierbar, Standard 30/Min)

• Schreibschutz – send_email und create_calendar_event erfordern einen confirm: true-Parameter

Voraussetzungen

• macOS (verwendet Schlüsselbund zur Speicherung von Anmeldedaten)

• Node.js 20+

• Amazon WorkMail-Konto mit Benutzername/Passwort-Authentifizierung

Einrichtung

1. Abhängigkeiten installieren

git clone https://github.com/your-username/workmail-mcp-server.git
cd workmail-mcp-server
npm install

2. Umgebung konfigurieren

cp .env.example .env

Bearbeiten Sie .env, falls sich Ihr WorkMail in einer anderen Region befindet:

WORKMAIL_MCP_EWS_ENDPOINT=https://ews.mail.us-west-2.awsapps.com/EWS/Exchange.asmx

Der EWS-Endpunkt folgt dem Muster https://ews.mail.<region>.awsapps.com/EWS/Exchange.asmx. Gängige Regionen: us-east-1, us-west-2, eu-west-1.

3. Anmeldedaten speichern

npm run setup-credentials

Dies fragt nach Ihrer WorkMail-E-Mail-Adresse und Ihrem Passwort, speichert diese im macOS-Schlüsselbund und validiert die Verbindung.

4. Build

npm run build

5. Bei Claude Desktop registrieren

Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "workmail": {
      "command": "node",
      "args": ["/absolute/path/to/workmail-mcp-server/dist/index.js"]
    }
  }
}

Starten Sie Claude Desktop neu. Der WorkMail-Server sollte als verbunden angezeigt werden.

Konfiguration

Alle Einstellungen sind optional und haben sinnvolle Standardwerte. Legen Sie diese in .env oder als Umgebungsvariablen fest:

Umgebungsvariablen, die in claude_desktop_config.json gesetzt sind, haben Vorrang vor .env.

Verwendung

Sobald die Verbindung hergestellt ist, können Sie Claude Desktop bitten, mit Ihrem WorkMail zu interagieren:

• "List my recent emails"

• "Read the email from Sarah about the Q3 report"

• "Search my inbox for messages about the deployment"

• "What meetings do I have this week?"

• "Send an email to team@example.com about the status update"

• "Create a meeting for tomorrow at 2pm with Alex"

Entwicklung

# Run directly from TypeScript (no build step)
npm run dev

# Rebuild after changes
npm run build

# Re-run credential setup
npm run setup-credentials

Protokolle werden im JSON-Format in stderr geschrieben. Um diese während der Ausführung über Claude Desktop zu sehen, überprüfen Sie die MCP-Server-Protokolle in den Entwicklertools von Claude Desktop.

Architektur

Claude Desktop  <──stdio──>  MCP Server (Node.js)
                                  │
                                  ▼
                            EWS Client Layer
                                  │
                                  ▼
                  Amazon WorkMail (Exchange Web Services)

Der Server verwendet das EWS-Protokoll auf der Kompatibilitätsebene Exchange2010_SP2, welche die von Amazon WorkMail unterstützte Version ist.

Lizenz

MIT