VOOZH about

URL: https://glama.ai/mcp/servers/leeguooooo/Mailbox?locale=zh-CN

⇱ MCP 电子邮件服务 by leeguooooo | Glama

邮箱 CLI

面向多账户 IMAP/SMTP 的 CLI 优先电子邮件管理工具，支持本地同步缓存。

主要接口：mailbox CLI（Node.js 实现）。本仓库通过 npm 提供预构建的平台二进制文件（最终用户无需安装 Python）。

支持的提供商

  • 163 邮箱 (mail.163.com / mail.126.com)

  • QQ 邮箱 (mail.qq.com)

  • Gmail (mail.google.com)

  • Outlook/Hotmail

  • 自定义 IMAP 服务器

Related MCP server: Email MCP Server

安装

npm (推荐)

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

npm 包为每个平台提供预构建的二进制文件（无需 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

缓存 + 同步

  • 缓存数据库默认路径：~/.local/share/mailbox/email_sync.db

  • 列表操作默认尽可能使用缓存。添加 --live 参数可强制使用 IMAP。

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

AI 使用指南

如果您要将此 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

A
license - permissive license
B
quality
A
maintenance

Maintenance

–Maintainers
–Response time
3wRelease cycle
14Releases (12mo)
Commit activity
Issues opened vs closed

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