MailCal installieren

In fünf Schritten vom leeren Rechner zum ersten Agenten mit Postfach und Kalender. Alle Beispiele verwenden Platzhalter – ersetzen Sie sie durch Ihre eigenen Werte.

Schritt 1

Voraussetzungen

Sie brauchen das .NET 10 SDK. Global installierte .NET-Tools landen in ~/.dotnet/tools – dieser Ordner muss in Ihrem PATH liegen.

Schritt 2

Tools installieren

Installieren Sie die Kommandozeile, den MCP-Server oder beide. Ein Zugangstoken für nuget.org ist nicht nötig.

dotnet tool install -g Ironbrain.MailCal.Cli
dotnet tool install -g Ironbrain.MailCal.Mcp
ironbrain-mailcal --version

Spätere Updates holen Sie mit dotnet tool update -g Ironbrain.MailCal.Cli bzw. Ironbrain.MailCal.Mcp.

Schritt 3

Konten konfigurieren

MailCal liest standardmäßig ~/.config/ironbrain/mailcal.json. Legen Sie die Datei an und schützen Sie sie, denn sie enthält Passwörter:

mkdir -p ~/.config/ironbrain
touch ~/.config/ironbrain/mailcal.json
chmod 600 ~/.config/ironbrain/mailcal.json

Das folgende Beispiel richtet zwei Konten ein: assistant darf senden, personal nur lesen.

{
  "defaultAccount": "assistant",
  "accounts": {
    "assistant": {
      "Email": {
        "Imap": {
          "Host": "mail.example.com",
          "Port": 993,
          "UseSsl": true,
          "Username": "bot@example.com",
          "Password": "REPLACE_ME"
        },
        "Smtp": {
          "Enabled": true,
          "Host": "mail.example.com",
          "Port": 587,
          "UseStartTls": true,
          "Username": "bot@example.com",
          "Password": "REPLACE_ME",
          "FromAddress": "bot@example.com",
          "FromName": "Assistant"
        }
      },
      "Calendar": {
        "HomeUrl": "https://mail.example.com/SOGo/dav/bot@example.com/Calendar/",
        "Username": "bot@example.com",
        "Password": "REPLACE_ME",
        "DefaultWriteCalendar": "personal"
      }
    },
    "personal": {
      "Email": {
        "Imap": {
          "Host": "mail.example.com",
          "Port": 993,
          "UseSsl": true,
          "Username": "you@example.com",
          "Password": "REPLACE_ME"
        },
        "Smtp": {
          "Enabled": false
        }
      }
    }
  }
}
  • Anderer Pfad: per --config oder Umgebungsvariable IRONBRAIN_MAILCAL_CONFIG.
  • Konto wählen: mit -a / --account oder IRONBRAIN_MAILCAL_ACCOUNT; ohne Angabe gilt defaultAccount.
  • Kalender: Mit HomeUrl findet MailCal alle Kalender des Kontos selbst, inklusive geteilter. DefaultWriteCalendar bestimmt, wohin neue Termine gehen.
  • Archiv: Ohne eigene Angabe archiviert MailCal nach Archive/{CurrentYear}.

Ein ausführlicheres Beispiel mit allen Optionen liegt im Repository unter samples/mailcal.example.json.

Schritt 4

Verbindung testen

Prüfen Sie, ob Konten, Postfächer und Kalender erreichbar sind. account list zeigt die Konfiguration ohne Passwörter an.

ironbrain-mailcal account list
ironbrain-mailcal -a assistant mail list --limit 5
ironbrain-mailcal -a personal mail list --limit 5
ironbrain-mailcal -a assistant cal calendars
ironbrain-mailcal -a assistant cal list --date today

Schritt 5

In Cursor einbinden

Am einfachsten über das MailCal-Plugin auf cursor.directory. Alternativ ergänzen Sie diesen Eintrag in Ihren MCP-Einstellungen:

{
  "mcpServers": {
    "ironbrain-mailcal-mcp": {
      "command": "ironbrain-mailcal-mcp",
      "env": {
        "IRONBRAIN_MAILCAL_CONFIG": "${HOME}/.config/ironbrain/mailcal.json"
      }
    }
  }
}

Andere MCP-Clients wie Claude Desktop binden den Server genauso als lokalen Befehl ein.

Sicherheit

  • Passwörter werden nie geloggt oder ausgegeben.
  • Die Konfigurationsdatei gehört nicht in ein Git-Repository und sollte nur für Ihren Benutzer lesbar sein.
  • Geben Sie Agenten für persönliche Postfächer am besten ein Konto ohne Versandrecht ("Enabled": false).

← Zurück zu MailCal Auf GitHub ansehen