Labsco
MCP SERVER

Pyfastmail MCP

by pjosols

Read, send, file and search a Fastmail account over JMAP — with contacts, calendars and file storage on the same connection.

Email: Mailboxes & Delivery
Summary
A mailbox an agent can actually work in.

Most email integrations read. This one also sends, files, archives and reorganises the mailboxes themselves, with the identity you reply from as an explicit choice — and contacts, calendar and files arrive over the same connection once the app password is in place.

What it is

A Fastmail client with a full write surface: it can send email, delete messages and modify contacts and calendars on your behalf. Mail and contacts go over JMAP with the API token alone; calendars over CalDAV and file storage over WebDAV are registered only when an app password is also present.

What you get
  • Email sent, replied to, moved, archived, pinned and deleted
  • Search across messages, and across snippets when you only remember a phrase
  • A whole thread read at once, and an individual message parsed
  • Mailboxes listed, created, renamed and deleted
  • Labels managed and read state set on a message
  • Messages imported and exported
  • Identities listed and set, so a reply leaves from the right address
  • A health check on the connection
  • Contacts over JMAP, plus calendars and file storage once the app password is supplied
Requirements

A Fastmail API token with the JMAP contacts capability enabled, as FASTMAIL_API_TOKEN, plus FASTMAIL_EMAIL. Calendars and files additionally need an app password with the DAV scope, as FASTMAIL_APP_PASSWORD. Install with pip install pyfastmail-mcp or run it under uvx.

Setup effort

One command plus a key — pip install pyfastmail-mcp, then supply credentials