How do I install the pyfastmail mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `FASTMAIL_API_TOKEN`, `FASTMAIL_APP_PASSWORD`, `FASTMAIL_EMAIL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Pyfastmail MCP Server

An [MCP](https://modelcontextprotocol.io/) server that gives AI assistants full access to your Fastmail account — email, contacts, calendars, and

Local serverstdio

What is the Pyfastmail MCP Server?

An MCP server that gives AI assistants full access to your Fastmail account — email, contacts, calendars, and file storage.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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.

Tool	What it does
health_check	Verify connection and auth
mail_list_mailboxes	List all mailboxes (folders/labels)
mail_create_mailbox	Create a mailbox
mail_rename_mailbox	Rename a mailbox
mail_delete_mailbox	Delete a mailbox
mail_get_email	Get email by ID (with optional headers)
mail_get_recent_emails	Get recent emails
mail_search_emails	Search by query
mail_search_snippets	Highlighted search result snippets
mail_get_email_thread	Get full thread
mail_mark_email_read	Mark read/unread
mail_pin_email	Pin/unpin (flag/star)
mail_move_email	Move to mailbox
mail_delete_email	Move to trash or permanently delete
mail_archive_email	Archive
mail_manage_email_labels	Add/remove keywords
mail_export_email	Download raw .eml file
mail_import_email	Import .eml into mail store
mail_parse_email	Parse a blob as email without importing
mail_list_identities	List send-as identities
mail_set_identity	Create/update/delete identities
mail_send_email	Send new email
mail_reply_to_email	Reply to email
mail_forward_email	Forward email
mail_list_masked_emails	List masked emails
mail_create_masked_email	Create masked email
mail_update_masked_email	Update masked email state, domain, description, or URL
mail_download_attachment	Download attachment
mail_upload_attachment	Upload blob for sending
contacts_list_address_books	List address books
contacts_list	List contacts (query+get combo)
contacts_get_contact	Get contact(s) by ID
contacts_query_contacts	Query contacts with filters and sorting
contacts_create_contact	Create contact
contacts_update_contact	Update contact fields
contacts_delete_contact	Delete contact(s)
calendar_list_calendars	List calendars
calendar_list_events	List events
calendar_get_event	Get event details
calendar_create_event	Create event
calendar_update_event	Update event
calendar_delete_event	Delete event
files_list	List files/folders
files_get	Download file
files_upload	Upload file
files_create_folder	Create folder
files_move	Move/rename file
files_delete	Delete file/folder

How to install the Pyfastmail MCP Server

{
  "mcpServers": {
    "fastmail": {
      "command": "uvx",
      "args": [
        "pyfastmail-mcp"
      ],
      "env": {
        "FASTMAIL_API_TOKEN": "YOUR_FASTMAIL_API_TOKEN",
        "FASTMAIL_APP_PASSWORD": "YOUR_FASTMAIL_APP_PASSWORD",
        "FASTMAIL_EMAIL": "you@fastmail.com"
      }
    }
  }
}

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

Configuration

Variable	Description	Required
FASTMAIL_API_TOKEN	Declared in the maintainer’s client configuration.	Check documentation
FASTMAIL_APP_PASSWORD	Declared in the maintainer’s client configuration.	Check documentation
FASTMAIL_EMAIL	Declared in the maintainer’s client configuration.	Check documentation

Frequently asked questions

An [MCP](https://modelcontextprotocol.io/) server that gives AI assistants full access to your Fastmail account — email, contacts, calendars, and file storage. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.