Mailbox CLI

Интерфейс командной строки (CLI) для управления несколькими учетными записями IMAP/SMTP с локальным кэшем синхронизации.

Основной интерфейс: CLI mailbox (реализация на Node.js). Этот репозиторий поставляет готовые бинарные файлы для платформ через npm (конечным пользователям Python не требуется).

Поддерживаемые провайдеры

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

• QQ Mail (mail.qq.com)

• Gmail (mail.google.com)

• Outlook/Hotmail

• Пользовательские IMAP-серверы

Related MCP server: Email SMTP/IMAP MCP Server

Установка

npm (рекомендуется)

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

Пакет npm поставляет готовые бинарные файлы для каждой платформы (Python не требуется).

Как навык ИИ (Claude Code / Cursor / и т.д.)

# 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

Навык предполагает, что CLI находится в PATH (npm install -g @leeguoo/mailbox-cli). Для максимального ускорения также один раз выполните mailbox daemon install.

MCP-сервер (Claude Desktop / Code / Cursor)

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

Из исходного кода (разработка)

pnpm install
pnpm test

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

Настройка учетных записей

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

Расположение конфигураций:

• Учетные данные: ~/.config/mailbox/auth.json

• Другие настройки: ~/.config/mailbox/config.toml

Общие команды

# 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

Кэш + синхронизация

• База данных кэша по умолчанию: ~/.local/share/mailbox/email_sync.db

• Список по умолчанию использует кэш, где это возможно. Добавьте --live для принудительного использования IMAP.

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

Руководство по использованию ИИ

Если вы интегрируете этот CLI в ИИ-агент, начните отсюда:

• docs/AI_SKILL_MAILBOX_CLI.md

Интеграция с OpenClaw

Этот репозиторий включает навык OpenClaw в skills/mailbox/SKILL.md.

OpenClaw загружает навыки из:

• <workspace>/skills

• ~/.openclaw/skills

Помощник для быстрой ссылки (символическая ссылка в ~/.openclaw/skills):

./scripts/link_openclaw_skill.sh

Принудительная замена существующей ссылки:

./scripts/link_openclaw_skill.sh --force

Чтобы использовать этот репозиторий без копирования файлов, добавьте каталог навыков репозитория в skills.load.extraDirs в ~/.openclaw/openclaw.json:

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

OpenClaw обрабатывает доставку каналов и планирование; mailbox возвращает структурированные JSON-выводы и дополнительные текстовые сводки.

Проверьте, что OpenClaw распознал навык:

openclaw skills list --eligible
openclaw skills check

Контракт

• docs/CLI_JSON_CONTRACT.md