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 for JMAP protocol access; the MCP package adapts those typed operations into tools.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
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 for JMAP protocol access; the MCP package adapts those typed operations into tools.
A Model Context Protocol (MCP) server that provides tools for interacting with JMAP (JSON Meta Application Protocol) email servers. Built with Deno and using the jmap-jam client library.
Standalone applications can import @wyattjoh/jmap without creating an MCP
server or transport:
import { connectJmap, searchEmails } from "jsr:@wyattjoh/jmap";
const connection = await connectJmap({
sessionUrl: Deno.env.get("JMAP_SESSION_URL")!,
bearerToken: Deno.env.get("JMAP_BEARER_TOKEN")!,
accountId: Deno.env.get("JMAP_ACCOUNT_ID"),
});
const unread = await searchEmails(connection, {
filter: { inMailbox: "inbox-id", notKeyword: "$seen" },
limit: 50,
position: 0,
});
See packages/jmap/README.md for the client package.
Install via the plugin marketplace:
/plugin marketplace add wyattjoh/claude-code-marketplace
/plugin install jmap-mcp@wyattjoh-marketplace
Then configure the required environment variables in your MCP server settings.
Add the following to your agent of choice:
{
"mcpServers": {
"jmap": {
"type": "stdio",
"command": "deno",
"args": [
"run",
"--allow-net=api.fastmail.com",
"--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
"jsr:@wyattjoh/[email protected]"
],
"env": {
"JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
"JMAP_BEARER_TOKEN": "YOUR_API_TOKEN"
}
}
}
}
Replace
api.fastmail.comin--allow-netwith your JMAP server's hostname if not using FastMail.
get_mailboxesList mailboxes/folders with their IDs, names, and metadata. Call this first
to get mailbox IDs needed by search_emails (inMailbox) and move_emails
(mailboxId). Common names: Inbox, Drafts, Sent, Trash, Archive, Spam/Junk.
Parameters:
parentId (optional): Filter by parent mailbox IDlimit (optional): Max results (1-200, default: 100)position (optional): Starting position for paginationsearch_emailsSearch emails with filters. All filters are AND'd together. Returns only
email IDs — use get_emails to fetch content. Results include queryState for
incremental sync via get_search_updates.
Parameters:
query (optional): Text search across all fieldsbody (optional): Search in message body onlyfrom (optional): Filter by sender email addressto (optional): Filter by recipient email addresssubject (optional): Filter by subject textinMailbox (optional): Mailbox ID to search within (get from get_mailboxes)hasKeyword (optional): Filter by keyword (e.g., $seen, $flagged)notKeyword (optional): Exclude by keyword (e.g., $seen, $draft)allInThreadHaveKeyword (optional): All emails in thread must have keywordsomeInThreadHaveKeyword (optional): At least one email in thread must have
keywordbefore (optional): Only emails before date (ISO 8601 datetime)after (optional): Only emails after date (ISO 8601 datetime)limit (optional): Max results (1-100, default: 50)position (optional): Starting position for pagination (default: 0)get_emailsRetrieve specific emails by their IDs. Use properties to request only what you
need — fetching all properties returns large payloads.
Parameters:
ids: Array of email IDs (1-50 IDs)properties (optional): Specific properties to return. Recommended sets:
["id", "subject", "from", "to", "receivedAt", "preview"]["id", "subject", "from", "to", "cc", "receivedAt", "bodyValues", "textBody", "htmlBody"]bodyValues AND
textBody/htmlBodyget_threadsGet email threads by their IDs. Thread IDs come from get_emails responses
(threadId property). Returns email IDs per thread — use get_emails on those
IDs to fetch content.
Parameters:
ids: Array of thread IDs (1-20 IDs)get_email_changesGet IDs of emails created, updated, or destroyed since a previous state. Use the
state string from a get_emails response.
Parameters:
sinceState: State string from a previous get_emails responsemaxChanges (optional): Max changes to return (1-500)fetchEmails (optional): Auto-fetch full email details for changed IDs
(default: false)properties (optional): Properties to fetch when fetchEmails is trueget_search_updatesGet changes within a previous search query since its queryState. Must use the
same filter parameters as the original search_emails call.
Parameters:
sinceQueryState: queryState from a previous search_emails responsesearch_emails (must match original query)maxChanges (optional): Max changes to return (1-500)mark_emailsMark emails as read/unread or flagged/unflagged.
Parameters:
ids: Array of email IDs (1-100 IDs)seen (optional): Mark as read (true) or unread (false)flagged (optional): Mark as flagged (true) or unflagged (false)move_emailsMove emails to a different mailbox. Use get_mailboxes to find the target
mailbox ID.
Parameters:
ids: Array of email IDs (1-100 IDs)mailboxId: Target mailbox ID (get from get_mailboxes)patch_email_mailboxesAdd or remove selected mailbox memberships without replacing unspecified memberships. This supports label-like workflows and compound categorization.
Parameters:
ids: Array of email IDs (1-100 IDs)addMailboxIds (optional): Mailbox IDs to addremoveMailboxIds (optional): Mailbox IDs to removeAt least one mailbox must be added or removed. A mailbox cannot appear in both arrays.
delete_emailsDelete emails permanently (cannot be undone). Prefer moving to Trash via
move_emails for recoverable deletion.
Parameters:
ids: Array of email IDs (1-100 IDs)send_emailSend a new email. Requires either textBody or htmlBody (or both).
Parameters:
to: Array of recipients (name optional, email required)cc (optional): Array of CC recipientsbcc (optional): Array of BCC recipientssubject: Email subjecttextBody (optional): Plain text bodyhtmlBody (optional): HTML bodyidentityId (optional): JMAP identity ID to send from (uses server default if
omitted)reply_to_emailReply to an existing email. Automatically sets To/CC, Re: subject prefix, and threading headers (In-Reply-To, References).
Parameters:
emailId: ID of email to reply toreplyAll (optional): Include all original recipients (default: false)subject (optional): Custom reply subject (defaults to Re: <original>)textBody (optional): Plain text bodyhtmlBody (optional): HTML bodyidentityId (optional): JMAP identity ID to send from (uses server default if
omitted)This server should work with any JMAP-compliant email server, including:
deno task watch # Run with file watching
deno task start # Run without watching
deno task test # Run all tests
deno task check # Type-check both packages
deno task lint # Lint workspace packages
deno task fmt # Format code
deno task publish:check # Validate both JSR packages
The repository is a Deno workspace with two independently publishable packages:
packages/jmap / @wyattjoh/jmap: Functional connection, retrieval,
incremental sync, mutation, and submission operationspackages/jmap-mcp / @wyattjoh/jmap-mcp: MCP schemas, tool adapters,
capability registration, and stdio entrypointThe MCP adapters call the client package directly. JMAP behavior belongs in the client package; transport validation and user-facing tool contracts belong in the MCP package.
MIT License - see LICENSE file for details.
A Model Context Protocol (MCP) server that provides tools for interacting with JMAP (JSON Meta Application Protocol) email servers. Built with Deno and using the jmap-jam client library.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Jmap 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 A Model Context Protocol (MCP) server that provides tools for interacting with JMAP (JSON Meta Application Protocol) email servers. Built with Deno and using the jmap-jam client library.