Mailbox CLI
ローカル同期キャッシュを備えた、マルチアカウントIMAP/SMTP向けのCLIファーストなメール管理ツール。
主要インターフェース: mailbox CLI (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 MCP Server
インストール
npm (推奨)
npm install -g @leeguoo/mailbox-cli
mailbox --helpnpmパッケージはプラットフォームごとにビルド済みのバイナリを提供します(Pythonは不要です)。
AIスキルとして (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キャッシュ + 同期
キャッシュDBのデフォルト:
~/.local/share/mailbox/email_sync.dbリスト表示は可能な限りデフォルトでキャッシュを使用します。IMAPを強制するには
--liveを追加してください。
mailbox sync status --json
mailbox sync force --json
mailbox sync init
mailbox sync daemonAI利用ガイド
このCLIをAIエージェントに統合する場合は、ここから始めてください:
docs/AI_SKILL_MAILBOX_CLI.md
OpenClaw統合
このリポジトリには skills/mailbox/SKILL.md にOpenClawスキルが含まれています。
OpenClawは以下の場所からスキルを読み込みます:
<workspace>/skills~/.openclaw/skills
クイックリンクヘルパー (~/.openclaw/skills へのシンボリックリンク):
./scripts/link_openclaw_skill.sh既存のリンクを強制的に置き換える:
./scripts/link_openclaw_skill.sh --forceファイルをコピーせずにこのリポジトリを使用するには、~/.openclaw/openclaw.json の skills.load.extraDirs にリポジトリのスキルディレクトリを追加してください:
{
"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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/leeguooooo/Mailbox'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
