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
