Fastmail MCP Server (Неофициальный)

Неофициальный сервер Model Context Protocol для интеграции с Fastmail. Предоставляет единственный инструмент execute, который выступает в качестве проверенного прокси-сервера JMAP — LLM записывает необработанные вызовы методов JMAP, а сервер берет на себя проверку, аутентификацию и очистку ответов.

Инструкции по настройке

1. Получите ваш API-токен Fastmail

1. Войдите в Fastmail

2. Перейдите в Settings (Настройки) → Privacy & Security (Конфиденциальность и безопасность) → API tokens (API-токены)

3. Нажмите New API token (Новый API-токен)

4. Дайте ему имя (например, "Claude MCP")

5. Выберите необходимые области доступа (scopes): Mail (чтение/запись по мере необходимости)

6. Скопируйте сгенерированный токен

2. Настройте Claude Code

Добавьте следующее в настройки MCP Claude Code (~/.claude/claude_desktop_config.json или проектный .mcp.json):

{
  "mcpServers": {
    "fastmail": {
      "type": "url",
      "url": "https://fastmail-mcp.i11v.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

Примечание по безопасности: Храните свой API-токен в безопасности. Никогда не добавляйте его в систему контроля версий. Рассмотрите возможность использования переменных окружения или менеджера секретов.

Доступные инструменты

execute

Выполнение вызовов методов JMAP к Fastmail. Принимает массив троек вызовов методов JMAP [methodName, args, callId].

Входные данные:

{
  "methodCalls": [
    ["Email/query", {
      "filter": { "inMailbox": "INBOX_ID" },
      "sort": [{ "property": "receivedAt", "isAscending": false }],
      "limit": 10
    }, "call-0"],
    ["Email/get", {
      "ids": { "resultOf": "call-0", "name": "Email/query", "path": "/ids" },
      "properties": ["from", "subject", "receivedAt", "preview"]
    }, "call-1"]
  ]
}

Что делает сервер:

• Проверяет структуру, имена методов и правила гигиены

• Автоматически внедряет accountId

• Отправляет запрос в JMAP API Fastmail

• Удаляет протокольный шум (state, queryState, canCalculateChanges и т. д.)

• Возвращает очищенные methodResponses

Разрешенные методы JMAP:

• Core/echo

• Mailbox/get, Mailbox/query, Mailbox/queryChanges, Mailbox/set

• Email/get, Email/query, Email/queryChanges, Email/set

• Thread/get

• SearchSnippet/get

• Identity/get

• EmailSubmission/get, EmailSubmission/query, EmailSubmission/set

Правила проверки:

• Каждый вызов /get (кроме Mailbox/get, Identity/get) должен включать массив properties

• Каждый вызов /query должен включать limit

• ids: null в вызовах /get отклоняется (сначала используйте /query)

• Деструктивные операции (destroy, EmailSubmission/set) возвращают ошибку с запросом подтверждения пользователя

compose_email (MCP App)

Открывает интерактивную форму создания письма. Опционально предварительно заполняет поля (кому, копия, скрытая копия, тема, тело). На хостах, поддерживающих MCP Apps, отображает встроенный интерфейс создания письма с кнопками отправки и сохранения черновика. На других хостах переключается на структурированный текст.

Входные данные:

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message text..."
}

read_email (MCP App)

Отображает полное содержимое письма в расширенном режиме чтения. Получает письмо по JMAP ID и отображает заголовки, очищенное тело письма и кнопки действий (ответить, ответить всем, переслать). На хостах без поддержки MCP Apps переключается на структурированный текст.

Входные данные:

{
  "emailId": "M1234abcd"
}

Доступные ресурсы

MCP-клиенты с поддержкой ресурсов автоматически получают навык Fastmail — набор файлов в формате markdown, обучающих LLM работе с инструментом execute JMAP. Клиенты, поддерживающие приоритет ресурсов, сначала загружают SKILL.md и переходят по его ссылкам по мере необходимости.

Все ресурсы используют схему URI file:///fastmail-skill/<path> и тип mime text/markdown. Тег audience: ["assistant"].

API Endpoints

• POST /mcp - Эндпоинт протокола MCP

• GET /health - Эндпоинт проверки работоспособности

Переменные окружения

Скопируйте .env.example в .env.development.local и заполните значения:

cp .env.example .env.development.local

Разработка

pnpm install   # Install dependencies
pnpm dev       # Run local dev server (wrangler)
pnpm check     # Run all checks (typecheck + lint + fmt + test)
pnpm run deploy:prod  # Deploy to Cloudflare

Это неофициальный общественный проект, не связанный с Fastmail.

Исходный код и проблемы: GitHub