← Back to search

@jordonh19/fastmail-mcp-server

GitHub Actions Scanned 22d ago

MCP server for Fastmail — enables AI assistants to read, search, send, and manage emails, calendars, and contacts via the JMAP protocol

npm
C
68 / 100

Versions

1.3.0latest
Jun 22, 2026
1.2.0
Mar 16, 2026
1.1.1
Mar 16, 2026
1.0.1
Mar 13, 2026
1.0.0
Mar 13, 2026
PermissionsTool SafetyAuthAnnotationsCode QualityStabilitySpecVuln HistoryAuthorTransparencyCommunity

Tools 47

summarize_email
annotations: none low

Use the connected LLM to produce a concise summary of an email

emailId string
suggest_reply
annotations: none low

Use the connected LLM to draft a reply to an email based on the provided intent or instructions. Requires the MCP client to support sampling.

emailId string
send_email
annotations: none low

Compose and send a new email. Use get_identities first to find available sender identities.

body string subject string
reply_email
annotations: none low

Reply to an existing email. Automatically sets threading headers (In-Reply-To, References) and determines recipients.

body string emailId string
forward_email
annotations: none low

Forward an existing email to new recipients with an optional message

emailId string
create_draft
annotations: none low

Save an email as a draft without sending. The draft can be edited or sent later using send_draft.

body string subject string
send_draft
annotations: none low

Send a previously saved draft email. The draft must already exist in the Drafts mailbox.

emailId string
list_address_books
annotations: none low

List all address books (contact groups) in the Fastmail account

search_contacts
annotations: none low

Search contacts by name, email, or other criteria. Returns a summary list of matching contacts.

get_contact
annotations: none low

Get full details of a specific contact by their ID

create_contact
annotations: none low

Create a new contact in the Fastmail address book

notes string number string address string jobTitle string
delete_contact
annotations: none low

Delete a contact by their ID

contactId string
update_contact
annotations: none low

Update an existing contact

notes string number string address string jobTitle string contactId string
search_emails
annotations: none low

Search for emails using filters like sender, recipient, subject, date range, or full-text query. Use this tool when you need to find specific emails matching particular criteria. For simply checking recent emails, use get_latest_emails instead. For unread emails only, use get_unread_emails instead.

to string from string after string query string before string subject string mailboxId string hasAttachment boolean
get_email
annotations: none low

Get the full content of a specific email by its ID, including headers, body text, and attachment info

emailId string
get_email_headers
annotations: none low

Get selected raw email headers for a message without returning the full body. Defaults to unsubscribe, reply routing, return path, and authentication headers.

emailId string
one_click_unsubscribe
annotations: none low

Unsubscribe from a message using one-click unsubscribe headers. Only posts to safe HTTPS List-Unsubscribe URLs when List-Unsubscribe-Post advertises one-click unsubscribe.

emailId string
get_thread
annotations: none low

Get all emails in a conversation thread, showing the full discussion chronologically

threadId string
get_unread_emails
annotations: none low

Retrieve unread emails, optionally filtered by mailbox. Best for checking what needs attention. Do not use search_emails for this purpose.

mailboxId string
get_latest_emails
annotations: none low

Get the most recent emails sorted by date. Best for quickly checking recent activity without specific search criteria. Do not use search_emails for this purpose.

mailboxId string
get_mailbox_emails
annotations: none low

List emails in a specific mailbox with pagination support. Use this when browsing a folder

mailboxId string
get_email_attachments
annotations: none low

List the attachments on a specific email without returning the full email body. Use this when you only need filenames, types, sizes, and blob IDs before calling download_attachment.

emailId string
download_attachment
annotations: none low

Download an email attachment by its blob ID. Use get_email first to find attachment blob IDs. Returns text content directly for text files, or base64-encoded data for binary files. Maximum attachment size is 10 MB.

name string blobId string
move_email
annotations: none low

Move an email to a different mailbox (folder). Use list_mailboxes to find mailbox IDs.

emailId string mailboxId string
add_labels
annotations: none low

Add one or more mailbox labels to an email without removing its existing mailbox assignments.

emailId string
remove_labels
annotations: none low

Remove one or more mailbox labels from an email while preserving any other mailbox assignments.

emailId string
update_email_flags
annotations: none low

Update email flags (read/unread status, flagged/unflagged status)

emailId string
delete_email
annotations: none low

Delete an email. By default moves to Trash. Set permanent=true to permanently destroy the email.

emailId string
bulk_email_action
annotations: none low

Perform an action on multiple emails at once. Supports marking as read/unread, flagging/unflagging, moving, and deleting.

bulk_add_labels
annotations: none low

Add one or more mailbox labels to multiple emails at once while preserving their other mailbox assignments.

bulk_remove_labels
annotations: none low

Remove one or more mailbox labels from multiple emails at once while preserving any other mailbox assignments.

archive_email
annotations: none low

Move one or more emails to the Archive mailbox. A convenient one-step operation for archiving emails you

mark_mailbox_read
annotations: none low

Mark all emails in a specific mailbox as read. Useful for clearing unread counts on a mailbox. Processes up to 500 unread emails at a time.

mailboxId string
get_mailbox_stats
annotations: none low

Get compact mailbox statistics such as email counts, unread counts, and thread counts. Use this when you need an overview instead of listing mailbox contents.

get_account_summary
annotations: none low

Get a compact account-level summary with unique email totals, unread counts, mailbox counts, and top mailboxes. Prefer this over large list calls when you only need an overview.

list_calendars
annotations: none low

List all calendars in the Fastmail account with their names, colors, and visibility status

get_calendar_events
annotations: none low

Get calendar events within a date range. Optionally filter by calendar ID or search text.

get_calendar_event
annotations: none low

Get the full details of a specific calendar event by its ID

eventId string
create_calendar_event
annotations: none low

Create a new calendar event. Use list_calendars first to get calendar IDs.

name string email string title string location string
update_calendar_event
annotations: none low

Update an existing calendar event. Only specified fields will be changed.

title string eventId string location string
delete_calendar_event
annotations: none low

Delete a calendar event by its ID

check_function_availability
annotations: none low

Check which major Fastmail feature groups are available for this account and MCP client, including setup guidance for missing mail, submission, contacts, calendars, or sampling support.

get_identities
annotations: none low

List all sender identities (email addresses) available for sending emails

list_mailboxes
annotations: none low

List all mailboxes (folders) in the Fastmail account with their roles, email counts, and IDs

create_mailbox
annotations: none low

Create a new mailbox (folder) in the Fastmail account

name string
rename_mailbox
annotations: none low

Rename an existing mailbox (folder). Use list_mailboxes to find the mailbox ID.

newName string mailboxId string
delete_mailbox
annotations: none low

Delete a mailbox (folder). The mailbox must be empty or you must set force=true to delete with all contents. System mailboxes (Inbox, Trash, etc.) cannot be deleted.

mailboxId string

Permissions 3

network medium
Server uses network capabilities via: fetch()
shell high
Server uses shell capabilities via: child_process, execSync()
env_vars low
Server uses env_vars capabilities via: process.env

Scan Findings 106

low
Tool 'summarize_email' has no annotations annotation_checker · 100%
low
Tool 'suggest_reply' has no annotations annotation_checker · 100%
low
Tool 'send_email' has no annotations annotation_checker · 100%
low
Tool 'reply_email' has no annotations annotation_checker · 100%
low
Tool 'forward_email' has no annotations annotation_checker · 100%
low
Tool 'create_draft' has no annotations annotation_checker · 100%
low
Tool 'send_draft' has no annotations annotation_checker · 100%
low
Tool 'list_address_books' has no annotations annotation_checker · 100%
low
Tool 'search_contacts' has no annotations annotation_checker · 100%
low
Tool 'get_contact' has no annotations annotation_checker · 100%
low
Tool 'create_contact' has no annotations annotation_checker · 100%
low
Tool 'delete_contact' has no annotations annotation_checker · 100%
low
Tool 'update_contact' has no annotations annotation_checker · 100%
low
Tool 'search_emails' has no annotations annotation_checker · 100%
low
Tool 'get_email' has no annotations annotation_checker · 100%
low
Tool 'get_email_headers' has no annotations annotation_checker · 100%
low
Tool 'one_click_unsubscribe' has no annotations annotation_checker · 100%
low
Tool 'get_thread' has no annotations annotation_checker · 100%
low
Tool 'get_unread_emails' has no annotations annotation_checker · 100%
low
Tool 'get_latest_emails' has no annotations annotation_checker · 100%
low
Tool 'get_mailbox_emails' has no annotations annotation_checker · 100%
low
Tool 'get_email_attachments' has no annotations annotation_checker · 100%
low
Tool 'download_attachment' has no annotations annotation_checker · 100%
low
Tool 'move_email' has no annotations annotation_checker · 100%
low
Tool 'add_labels' has no annotations annotation_checker · 100%
low
Tool 'remove_labels' has no annotations annotation_checker · 100%
low
Tool 'update_email_flags' has no annotations annotation_checker · 100%
low
Tool 'delete_email' has no annotations annotation_checker · 100%
low
Tool 'bulk_email_action' has no annotations annotation_checker · 100%
low
Tool 'bulk_add_labels' has no annotations annotation_checker · 100%
low
Tool 'bulk_remove_labels' has no annotations annotation_checker · 100%
low
Tool 'archive_email' has no annotations annotation_checker · 100%
low
Tool 'mark_mailbox_read' has no annotations annotation_checker · 100%
low
Tool 'get_mailbox_stats' has no annotations annotation_checker · 100%
low
Tool 'get_account_summary' has no annotations annotation_checker · 100%
low
Tool 'list_calendars' has no annotations annotation_checker · 100%
low
Tool 'get_calendar_events' has no annotations annotation_checker · 100%
low
Tool 'get_calendar_event' has no annotations annotation_checker · 100%
low
Tool 'create_calendar_event' has no annotations annotation_checker · 100%
low
Tool 'update_calendar_event' has no annotations annotation_checker · 100%
low
Tool 'delete_calendar_event' has no annotations annotation_checker · 100%
low
Tool 'check_function_availability' has no annotations annotation_checker · 100%
low
Tool 'get_identities' has no annotations annotation_checker · 100%
low
Tool 'list_mailboxes' has no annotations annotation_checker · 100%
low
Tool 'create_mailbox' has no annotations annotation_checker · 100%
low
Tool 'rename_mailbox' has no annotations annotation_checker · 100%
low
Tool 'delete_mailbox' has no annotations annotation_checker · 100%
info
Sandbox failed to start for behavioral verification behavioral_verifier · 100%
medium
Vulnerable dependency: vitest@4.1.0 (GHSA-82fw-gwwq-j7x9) dependency_analyzer · 95%
info
package.json metadata manifest_parser · 100%
info
Tool: summarize_email manifest_parser · 70%
info
Tool: suggest_reply manifest_parser · 70%
info
Tool: send_email manifest_parser · 70%
info
Tool: reply_email manifest_parser · 70%
info
Tool: forward_email manifest_parser · 70%
info
Tool: create_draft manifest_parser · 70%
info
Tool: send_draft manifest_parser · 70%
info
Tool: list_address_books manifest_parser · 70%
info
Tool: search_contacts manifest_parser · 70%
info
Tool: get_contact manifest_parser · 70%
info
Tool: create_contact manifest_parser · 70%
info
Tool: delete_contact manifest_parser · 70%
info
Tool: update_contact manifest_parser · 70%
info
Tool: search_emails manifest_parser · 70%
info
Tool: get_email manifest_parser · 70%
info
Tool: get_email_headers manifest_parser · 70%
info
Tool: one_click_unsubscribe manifest_parser · 70%
info
Tool: get_thread manifest_parser · 70%
info
Tool: get_unread_emails manifest_parser · 70%
info
Tool: get_latest_emails manifest_parser · 70%
info
Tool: get_mailbox_emails manifest_parser · 70%
info
Tool: get_email_attachments manifest_parser · 70%
info
Tool: download_attachment manifest_parser · 70%
info
Tool: move_email manifest_parser · 70%
info
Tool: add_labels manifest_parser · 70%
info
Tool: remove_labels manifest_parser · 70%
info
Tool: update_email_flags manifest_parser · 70%
info
Tool: delete_email manifest_parser · 70%
info
Tool: bulk_email_action manifest_parser · 70%
info
Tool: bulk_add_labels manifest_parser · 70%
info
Tool: bulk_remove_labels manifest_parser · 70%
info
Tool: archive_email manifest_parser · 70%
info
Tool: mark_mailbox_read manifest_parser · 70%
info
Tool: get_mailbox_stats manifest_parser · 70%
info
Tool: get_account_summary manifest_parser · 70%
info
Tool: list_calendars manifest_parser · 70%
info
Tool: get_calendar_events manifest_parser · 70%
info
Tool: get_calendar_event manifest_parser · 70%
info
Tool: create_calendar_event manifest_parser · 70%
info
Tool: update_calendar_event manifest_parser · 70%
info
Tool: delete_calendar_event manifest_parser · 70%
info
Tool: check_function_availability manifest_parser · 70%
info
Tool: get_identities manifest_parser · 70%
info
Tool: list_mailboxes manifest_parser · 70%
info
Tool: create_mailbox manifest_parser · 70%
info
Tool: rename_mailbox manifest_parser · 70%
info
Tool: delete_mailbox manifest_parser · 70%
info
Transport: stdio manifest_parser · 90%
info
Required env vars (1) manifest_parser · 80%
info
Sandbox failed to start for output poisoning scan output_poisoning · 100%
medium
Permission: network access detected permission_analyzer · 70%
high
Permission: shell access detected permission_analyzer · 95%
low
Permission: env_vars access detected permission_analyzer · 90%
critical
Tool poisoning in 'delete_mailbox': Directive language: 'you must' poisoning · 85%
info
SBOM generated: 189 components sbom_generator · 100%
medium
No build provenance detected (SLSA L0) slsa_assessor · 90%