fastmail-mcp
by MadLlama25·★ 119·Score 49
A comprehensive MCP server providing access to Fastmail's email, contacts, and calendar APIs for AI assistants.
Overview
This MCP server offers extensive functionality for interacting with Fastmail services through the JMAP API and CalDAV protocol. It provides comprehensive email operations including listing, searching, reading, sending, and managing emails with advanced features like threading, attachments, and bulk operations. The server also supports contact management and calendar functionality, automatically falling back to CalDAV for calendar access when JMAP is unavailable. The implementation is production-ready with clear documentation, multiple installation methods, and proper error handling.
Try asking AI
After installing, here are 6 things you can ask your AI assistant:
When to choose this
Choose this server if you need comprehensive AI access to Fastmail's email, contacts, and calendar services with rich functionality including threading, attachments, and bulk operations.
When NOT to choose this
Don't choose this if you use a different email provider as it's specifically built for Fastmail's API and authentication system.
Tools this server exposes
12 tools extracted from the READMEcheck_function_availabilityCheck what's available and get setup guidance
send_emailSend an email with proper draft/sent handling
get_recent_emailsGet the most recent emails from a mailbox
advanced_searchAdvanced email search with multiple criteria
list_contactsList all contacts in your account
list_calendar_eventsList calendar events from your calendars
get_emailGet a specific email by ID
reply_emailReply to an existing email with proper threading
move_emailMove an email to a different mailbox
create_calendar_eventCreate a new calendar event
list_mailboxesGet all mailboxes in your account
search_contactsSearch contacts by name or email
Comparable tools
Installation
Installation
Prerequisites
- Node.js 20+
- A Fastmail account with API access
- Fastmail API token
Installation Steps
- Clone or download this repository
- Install dependencies:
``bash npm install ``
- Build the project:
``bash npm run build ``
- Set environment variables:
``bash export FASTMAIL_API_TOKEN="your_api_token_here" # Optional: customize base URL export FASTMAIL_BASE_URL="https://api.fastmail.com" # Optional: customize attachment download directory export FASTMAIL_DOWNLOAD_DIR="/path/to/your/downloads" ``
- Start the server:
``bash npm start ``
Claude Desktop Extension
- Build and pack:
``bash npm run build npx @anthropic-ai/dxt pack ``
- Install the .dxt file into Claude Desktop
FAQ
- What email operations does this server support?
- The server supports comprehensive email operations including listing, searching, reading, sending, and managing emails. It also features advanced capabilities like threading, attachment handling, bulk operations, and statistics.
- Does it support calendar access?
- Yes, the server supports calendar operations through both JMAP (when available) and automatically falls back to CalDAV for calendar access since Fastmail doesn't currently expose calendar access via JMAP API tokens.
- How do I get a Fastmail API token?
- Log in to Fastmail web interface, go to Settings → Privacy & Security, find 'Connected apps & API tokens' section, click 'Manage API tokens', then click 'New API token' to generate a token.
Compare fastmail-mcp with
Last updated · Auto-generated from public README + GitHub signals.