fastmail-mcp-server MCP Server

A Model Context Protocol (MCP) server for Fastmail. Enables any MCP-compatible AI assistant to read, search, send, and manage emails, calendars, and contacts in a Fastmail account via the JMAP…

Local serverstdioMIT

What is the fastmail-mcp-server MCP Server?

fastmail-mcp-server is an MCP project maintained in the jordonh18/fastmail-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for Fastmail. Enables any MCP-compatible AI assistant to read, search, send, and manage emails, calendars, and contacts in a…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @jordonh19/fastmail-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares FASTMAIL_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_emailsSearch emails by mailbox, text, sender, date range, attachments, and more.
get_emailGet full email content by ID.
get_email_headersGet selected email headers without returning the full message body.
get_threadGet all emails in a conversation thread.
get_unread_emailsQuickly retrieve unread emails, optionally filtered by mailbox.
get_latest_emailsGet the most recent emails from all or a specific mailbox.
get_mailbox_emailsList emails in a specific mailbox with pagination.
get_email_attachmentsList attachments on an email without returning the full message body.
send_emailCompose and send a new email.
reply_emailReply or reply-all to an email.
forward_emailForward an email to new recipients.
create_draftSave an email as a draft without sending.
send_draftSend a previously saved draft email.
move_emailMove an email to a different mailbox.
add_labelsAdd mailbox labels to an email while preserving existing mailbox assignments.
remove_labelsRemove mailbox labels from an email while preserving other mailbox assignments.
update_email_flagsMark emails as read/unread or flagged/unflagged.
delete_emailMove to Trash or permanently delete.
bulk_email_actionPerform actions on multiple emails at once.
bulk_add_labelsAdd mailbox labels to multiple emails at once.
bulk_remove_labelsRemove mailbox labels from multiple emails at once.
archive_emailMove one or more emails to the Archive mailbox.
mark_mailbox_readMark all emails in a mailbox as read.
get_mailbox_statsGet compact mailbox-level unread, email, and thread counts.
get_account_summaryGet a compact account overview with unique email totals and top mailboxes.
download_attachmentDownload an email attachment by blob ID.
one_click_unsubscribeSend a one-click unsubscribe request for an email.
list_mailboxesList all mailboxes or folders with roles and email counts.
create_mailboxCreate a new mailbox or folder.
rename_mailboxRename an existing mailbox or folder.
delete_mailboxDelete a mailbox or folder, optionally with force delete.
list_calendarsList all calendars with names, colors, and visibility.
get_calendar_eventsSearch or list calendar events by date range, calendar, or title.
get_calendar_eventGet full details of a specific calendar event.
create_calendar_eventCreate a new calendar event with location, participants, and alerts.
update_calendar_eventUpdate an existing calendar event.
delete_calendar_eventDelete a calendar event.
list_address_booksList all address books or contact groups.
search_contactsSearch contacts by name, email, or other criteria.
get_contactGet full details of a specific contact.
create_contactCreate a new contact with email, phone, organization, and more.
update_contactUpdate an existing contact's information.
delete_contactDelete a contact.
get_identitiesList available sender identities.
check_function_availabilityCheck which Fastmail feature groups and MCP client capabilities are available, with setup guidance for missing access.

How to install the fastmail-mcp-server MCP Server

{
  "mcpServers": {
    "fastmail": {
      "command": "npx",
      "args": [
        "@jordonh19/fastmail-mcp-server"
      ],
      "env": {
        "FASTMAIL_API_TOKEN": "YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
FASTMAIL_API_TOKENDeclared in the maintainer’s client configuration.Yes