Mailbox CLI

CLI-orientierte E-Mail-Verwaltung für IMAP/SMTP-Konten mit lokalem Synchronisierungs-Cache.

Primäre Schnittstelle: die mailbox CLI (Node.js-Implementierung). Dieses Repository liefert vorab erstellte Plattform-Binärdateien über npm (kein Python für Endbenutzer erforderlich).

Unterstützte Anbieter

• 163 Mail (mail.163.com / mail.126.com)

• QQ Mail (mail.qq.com)

• Gmail (mail.google.com)

• Outlook/Hotmail

• Benutzerdefinierte IMAP-Server

Related MCP server: Email SMTP/IMAP MCP Server

Installation

npm (empfohlen)

npm install -g @leeguoo/mailbox-cli
mailbox --help

Das npm-Paket liefert vorab erstellte Binärdateien pro Plattform (kein Python erforderlich).

Als KI-Skill (Claude Code / Cursor / etc.)

# Project scope — installs into ./.claude/skills/mailbox (or ./.cursor/skills/...):
npx skills add leeguooooo/Mailbox --skill mailbox

# User scope — installs into ~/.claude/skills/mailbox:
npx skills add leeguooooo/Mailbox --skill mailbox -g

Der Skill setzt voraus, dass sich die CLI im PATH befindet (npm install -g @leeguoo/mailbox-cli). Für die größte Geschwindigkeitssteigerung führen Sie zusätzlich einmal mailbox daemon install aus.

MCP-Server (Claude Desktop / Code / Cursor)

mailbox mcp config --json   # prints a paste-ready mcpServers entry

Aus dem Quellcode (Entwicklung)

pnpm install
pnpm test

# build a local platform binary into mailbox-cli/packages/<platform>/bin/mailbox
pnpm build:binary

Konten konfigurieren

mkdir -p ~/.config/mailbox
cp examples/accounts.example.json ~/.config/mailbox/auth.json

Konfigurationspfade:

• Anmeldedaten: ~/.config/mailbox/auth.json

• Weitere Einstellungen: ~/.config/mailbox/config.toml

Häufige Befehle

# CLI help
mailbox --help

# list accounts
mailbox account list --json

# list unread emails (cache by default)
mailbox email list --unread-only --limit 20 --json

# show one email
mailbox email show 123456 --account-id my_account_id --json

# mark read (use --dry-run to validate first)
mailbox email mark 123456 --read --account-id my_account_id --folder INBOX --dry-run --json
mailbox email mark 123456 --read --account-id my_account_id --folder INBOX --confirm --json

# delete
mailbox email delete 123456 --account-id my_account_id --folder INBOX --confirm --json

Cache + Synchronisierung

• Cache-DB-Standard: ~/.local/share/mailbox/email_sync.db

• Die Auflistung verwendet standardmäßig den Cache, sofern möglich. Fügen Sie --live hinzu, um IMAP zu erzwingen.

mailbox sync status --json
mailbox sync force --json
mailbox sync init
mailbox sync daemon

KI-Nutzungsleitfaden

Wenn Sie diese CLI in einen KI-Agenten integrieren, beginnen Sie hier:

• docs/AI_SKILL_MAILBOX_CLI.md

OpenClaw-Integration

Dieses Repository enthält einen OpenClaw-Skill unter skills/mailbox/SKILL.md.

OpenClaw lädt Skills aus:

• <workspace>/skills

• ~/.openclaw/skills

Schnellverknüpfungs-Hilfe (Symlink in ~/.openclaw/skills):

./scripts/link_openclaw_skill.sh

Einen bestehenden Link zwangsweise ersetzen:

./scripts/link_openclaw_skill.sh --force

Um dieses Repository ohne Kopieren von Dateien zu verwenden, fügen Sie das Skill-Verzeichnis des Repositorys zu skills.load.extraDirs in ~/.openclaw/openclaw.json hinzu:

{
  "skills": {
    "load": {
      "extraDirs": [
        "/path/to/mcp-email-service/skills"
      ]
    }
  }
}

OpenClaw übernimmt die Kanalzustellung und Zeitplanung; mailbox gibt strukturierte JSON-Ausgaben und optionale Textzusammenfassungen zurück.

Überprüfen, ob OpenClaw den Skill erkannt hat:

openclaw skills list --eligible
openclaw skills check

Vertrag

• docs/CLI_JSON_CONTRACT.md