radiosilence/fastmail-cli

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

79 stars 21 forks Качество 77 Тренд 35MIT

CLI и MCP сервер для Fastmail — электронная почта, контакты, замаскированная электронная почта, вложения, извлечение текста. JMAP + CardDAV + GraphQL.

Обзор

CLI для JMAP API Fastmail. Чтение, поиск, отправка, управление и просмотр электронной почты с вашего терминала или помощника ИИ. Fastmail отправляет официальный MCP-сервер (размещенный на api.fastmail.com/mcp, OAuth с диапазонами чтения/записи/отправки). Это нулевая настройка и охватывает больше набора Fastmail — календарь, заметки и каталог организаций, к которым fastmail-cli не прикасается. Fastmail-cli - это самостоятельная альтернатива: CLI и MCP-сервер, который вы запускаете самостоятельно, с открытым исходным кодом, с замаскированной электронной почтой, извлечением текста вложения, обучением спам-фильтру и потоком входящей почты в реальном времени, который официальный сервер не предлагает - плюс полная опека над маршрутом передачи данных. Используйте Fastmail для нулевого обслуживания и более широкого набора (календарь, заметки); используйте Fastmail-cli для CLI, почты, которая транслируется по мере поступления, инструментария для извлечения вложений / спама / обучения в масках / для самостоятельного хостинга и сохранения пути передачи данных.

Обзор (машинный перевод)

CLI для JMAP API Fastmail. Читайте, ищите, отправляйте, управляйте и просматривайте электронную почту с вашего терминала или помощника AI.

Особенности

Описание / Description

| Email | Список, поиск, чтение, отправка, ответ, пересылка, потоки, выбор идентичности, тела HTML, вложения файлов | | ** Почтовые ящики** | Списки папок, переместить электронные письма, пометить спам/читать | fastmail watch потоки, поступающие по почте как NDJSON над JMAP, толкают его в оболочку. Также подписка на GraphQL | Контакты | Поиск, создание, обновление, удаление контактов через CardDAV | | Приложения | Загрузить файлы, извлечь текст, изменить размер изображений | | Текст Экстракция | 56 форматов через kreuzberg | | Image Resizing | --max-size, чтобы изменить размер изображений при загрузке | Masked Email | Создание, список, включение/отключение псевдонимов MCP Server | Интеграция Клода с помощью протокола Model Context ** Shell Completions** | Bash, Zsh, Fish, PowerShell JSON Output Все команды выводят JSON для сценариев

##По сравнению с официальным MCP

Fastmail отправляет официальный MCP-сервер (перенаправлено с «api.fastmail»).

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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
Email	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

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на 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"
      }
    }
  }
}