Fastmail 的 CLI 和 MCP 服务器——电子邮件、联系人、掩蔽邮件、附件、文本提取。JMAP + CardDAV + GraphQL。
概览
用于Fastmail的JMAP API的CLI。通过终端或AI助手阅读、搜索、发送、管理和监控电子邮件。 Fastmail 提供官方 MCP 服务器（托管于 api.fastmail.com/mcp OAuth，支持读写/发送范围）。它是零设置，涵盖了 Fastmail 的更多套件——日历、笔记和组织目录，这些 fastmail-CLI 没有触及。Fastmail-CLI 是自架的替代方案：一个 CLI 和一个开源的 MCP 服务器，你自己运行，支持掩蔽邮件、附件文本提取、垃圾邮件过滤训练，以及官方服务器不提供的实时邮件流——同时完全托管数据路径。 用Fastmail做零维护和更广泛的套件（日历、笔记）;用fastmail-cli做脚本化的CLI、邮件流式邮件、隐藏邮件/附件提取/垃圾邮件培训工具，或者自托管数据路径。
概述（AI 翻译）
用于Fastmail的JMAP API的CLI。从终端或AI助手读取、搜索、发送、管理和监控邮件。
特色
| 特色 | 描述 |
|---|---|
| 电子邮件 | 列表、搜索、阅读、发送、回复、转发、主题、身份选择、HTML正文、文件附件 |
| 邮箱 | 列出文件夹，移动邮件，标记垃圾邮件/已读 |
| 实时 | fastmail watch 通过 JMAP 推送的 NDJSON 邮件流——将其导入 shell 循环。同时也是 GraphQL 订阅 |
| 联系人通过CardDAV搜索、创建、更新、删除联系人 | |
| 附件下载文件，提取文本，调整图片大小 | |
| 文本提取 | 56种格式，来自kreuzberg |
| 图像调整大小 | --max-size 以调整下载图片大小 |
| 蒙面邮件创建、列出、启用/禁用别名 | |
| MCP 服务器通过模型上下文协议实现 Claude 集成 | |
| 壳补全 | Bash、Zsh、Fish、PowerShell |
| JSON 输出所有命令输出 JSON 用于脚本 |
与Fastmail官方MCP相比
Fastmail 发布了官方的 MCP 服务器 （托管于 'api.fastmail.
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
fastmail-cli
CLI for Fastmail’s JMAP API. Read, search, send, manage and watch email from your terminal or AI assistant.
Features
| Feature | Description |
|---|---|
| List, search, read, send, reply, forward, threads, identity selection, HTML bodies, file attachments | |
| Mailboxes | List folders, move emails, mark spam/read |
| Real-time | fastmail watch streams arriving mail as NDJSON over JMAP push — pipe it into a shell loop. Also a GraphQL subscription |
| Contacts | Search, create, update, delete contacts via CardDAV |
| Attachments | Download files, extract text, resize images |
| Text Extraction | 56 formats via kreuzberg |
| Image Resizing | --max-size to resize images on download |
| Masked Email | Create, list, enable/disable aliases |
| MCP Server | Claude integration via Model Context Protocol |
| Shell Completions | Bash, Zsh, Fish, PowerShell |
| JSON Output | All commands output JSON for scripting |
Compared to Fastmail’s official MCP
Fastmail ships an official MCP server
(hosted at api.fastmail.com/mcp, OAuth with read/write/send scopes). It’s
zero-setup and covers more of Fastmail’s suite — calendar, notes, and org
directory that fastmail-cli doesn’t touch. fastmail-cli is the self-hosted
alternative: a CLI and an MCP server you run yourself, open source, with
masked email, attachment text extraction, spam-filter training, and a real-time
stream of incoming mail the official server doesn’t offer — plus full custody of
the data path.
fastmail-cli |
Fastmail official MCP | |
|---|---|---|
| Interface | CLI and MCP (stdio / HTTP) | MCP only |
| Setup | install + run the binary | add URL + OAuth, nothing to run |
| Auth | API token (+ app password for CardDAV) | OAuth: read / write / send |
| Hosting / data path | your machine or your own server | Fastmail-hosted |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"fastmail": {
"command": "mise",
"args": ["x", "--", "fastmail", "mcp"],
"env": {
"FASTMAIL_API_TOKEN": "your-token-here",
"FASTMAIL_USERNAME": "[email protected]",
"FASTMAIL_APP_PASSWORD": "your-app-password"
}
}
}
}