Mailly文档

安装与登录

mailly-cli 把邮箱、发信、模板、Campaign 和 Agent 草稿带到终端,也方便 Agent 调用。

mailly-cli 封装了 Mailly HTTP API。每个命令都支持 --json,人和脚本、Agent 都能直接使用。

安装

需要 Node.js 18+。

npm install -g mailly-cli
mailly --help

登录

# 打开浏览器授权(device code flow)
mailly login
# 远程或无图形环境:只打印授权链接
mailly login --no-browser
# CI:直接粘贴 API Key
mailly login <api-key>

mailly whoami
mailly balance

凭据优先级

  1. --api-key <key>
  2. 环境变量 MAILLY_API_KEY
  3. ~/.mailly/config.json,由 mailly login 写入,权限 0600

--base-url / MAILLY_BASE_URL 默认为 https://api.mailly.site。

不要把密码、验证码、token 或 API Key 发到 Agent 聊天里,也不要提交到代码仓库。

常用命令

# 列出邮箱并读取来信
mailly inbox addresses list
mailly inbox threads list --json
mailly inbox threads show <thread-id> --json

# 发送邮件
mailly send \
  --to friend@example.com \
  --subject "Hello from Mailly" \
  --from-email your-inbox@mailly.site \
  --html "<p>It works!</p>" \
  --text "It works!"

JSON 输出

成功时退出码为 0;失败时退出码为 1,并输出 {"success":false,"error":"..."}。

mailly balance --json

Agent Skill

CLI Skill 教 Agent 怎么用 CLI:JSON 输出、等待验证码、回复草稿,以及完整的命令参考。开通邮箱用不到它,见让 Agent 帮你开通邮箱。

mkdir -p ~/.claude/skills/mailly
curl -fsSL https://raw.githubusercontent.com/superagents-lab/mailly-cli/main/skills/mailly/SKILL.md \
  -o ~/.claude/skills/mailly/SKILL.md

本页内容