Для чего этот сервер?

Этот MCP-сервер подключает ИИ-агента к почтовому серверу через протокол JMAP. Вместо того чтобы вручную дёргать API, модель сама ищет письма, читает их, отправляет ответы, перемещает по папкам и отслеживает изменения. Проще говоря, он превращает почту в инструмент, с которым агент может работать напрямую — без лишних посредников и сложных скриптов.

Каталог MCP
wyattjoh/jmap-mcp

wyattjoh/jmap-mcp

от wyattjoh

MCP-сервер для работы с JMAP-почтой: поиск, чтение, отправка, перемещение и удаление писем, управление папками и синхронизация. Полезен разработчикам, автоматизирующим почту через FastMail, Cyrus и...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

JMAP MCP Server

A Deno workspace containing a functional JMAP email client and a Model Context Protocol (MCP) server built on top of it. The client package uses jmap-jam for JMAP protocol access; the MCP package adapts those typed operations into tools.

Features

Email Management Tools

Search Emails: Search emails with text queries, sender/recipient filters, date ranges, and keywords. All filters are AND'd together.
Get Emails: Retrieve specific emails by ID with configurable property selection
Get Threads: Retrieve email threads (conversation chains)
Mark Emails: Mark emails as read/unread, flagged/unflagged
Move Emails: Move emails to one mailbox
Patch Email Mailboxes: Add or remove selected mailbox memberships while preserving unspecified memberships
Delete Emails: Delete emails permanently

Mailbox Management

Get Mailboxes: List all mailboxes/folders with hierarchy support. Use this to find mailbox IDs needed by other tools.

Incremental Sync

Get Email Changes: Get IDs of emails created, updated, or destroyed since a previous state (state-based delta tracking)
Get Search Updates: Get additions/removals within a previous search query since its last queryState

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить wyattjoh/jmap-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"wyattjoh-jmap-mcp-oxxhdlmr3v\",\"type\":\"stdio\",\"command\":\"deno\",\"args\":[\"run\",\"--allow-net=api.fastmail.com\",\"--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID\",\"jsr:@wyattjoh/jmap-mcp@0.6.4\"],\"env\":{\"JMAP_SESSION_URL\":\"https://api.fastmail.com/jmap/session\",\"JMAP_BEARER_TOKEN\":\"YOUR_API_TOKEN\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add wyattjoh-jmap-mcp-oxxhdlmr3v --env JMAP_SESSION_URL=https://api.fastmail.com/jmap/session --env JMAP_BEARER_TOKEN=YOUR_API_TOKEN -- deno run --allow-net=api.fastmail.com --allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID jsr:@wyattjoh/jmap-mcp@0.6.4

Либо через JSON-конфиг:

claude mcp add-json wyattjoh-jmap-mcp-oxxhdlmr3v "{\"type\":\"stdio\",\"command\":\"deno\",\"args\":[\"run\",\"--allow-net=api.fastmail.com\",\"--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID\",\"jsr:@wyattjoh/jmap-mcp@0.6.4\"],\"env\":{\"JMAP_SESSION_URL\":\"https://api.fastmail.com/jmap/session\",\"JMAP_BEARER_TOKEN\":\"YOUR_API_TOKEN\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add wyattjoh-jmap-mcp-oxxhdlmr3v --env JMAP_SESSION_URL=https://api.fastmail.com/jmap/session --env JMAP_BEARER_TOKEN=YOUR_API_TOKEN -- deno run --allow-net=api.fastmail.com --allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID jsr:@wyattjoh/jmap-mcp@0.6.4

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.wyattjoh-jmap-mcp-oxxhdlmr3v]
command = "deno"
args = ["run", "--allow-net=api.fastmail.com", "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID", "jsr:@wyattjoh/jmap-mcp@0.6.4"]

[mcp_servers.wyattjoh-jmap-mcp-oxxhdlmr3v.env]
JMAP_SESSION_URL = "https://api.fastmail.com/jmap/session"
JMAP_BEARER_TOKEN = "YOUR_API_TOKEN"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите wyattjoh/jmap-mcp, а в поле команды запуска — строку ниже:

deno run --allow-net=api.fastmail.com --allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID jsr:@wyattjoh/jmap-mcp@0.6.4

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например wyattjoh-jmap-mcp-oxxhdlmr3v.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: wyattjoh-jmap-mcp-oxxhdlmr3v
    command: deno
    args:
      - "run"
      - "--allow-net=api.fastmail.com"
      - "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID"
      - "jsr:@wyattjoh/jmap-mcp@0.6.4"
    env:
      JMAP_SESSION_URL: https://api.fastmail.com/jmap/session
      JMAP_BEARER_TOKEN: YOUR_API_TOKEN

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "wyattjoh-jmap-mcp-oxxhdlmr3v": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/jmap-mcp@0.6.4"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "deno",
  "args": [
    "run",
    "--allow-net=api.fastmail.com",
    "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
    "jsr:@wyattjoh/jmap-mcp@0.6.4"
  ],
  "env": {
    "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
    "JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
  },
  "type": "stdio"
}