fastmail

This MCP server exposes a comprehensive set of tools for interacting with Fastmail via the Model Context Protocol. It provides email operations (listing mailboxes, retrieving and filtering emails, sending messages, marking read/unread, deleting, and moving emails), attachment handling, thread retrieval, advanced searching, bulk actions, contact lookups, and calendar management. It also includes identity management and account statistics. Use the available tools to integrate Fastmail data into AI assistants, enabling tasks such as reading new messages, composing emails, organizing mailboxes, and scheduling events directly from your application or workflow. The tools are designed to be invoked with clearly defined parameters (e.g., mailboxId, emailId, query, calendarId) and return structured results suitable for downstream processing by AI models.

Prerequisites:

• Node.js 18+ (install from https://nodejs.org)
• A Fastmail account with API access and a Fastmail API token

Installation steps:

1. Clone or download the repository
2. Install dependencies:

   npm install
   

3. Build the project (if applicable):

   npm run build
   

4. Configure environment variables (see Configuration section below) and run the server:

   export FASTMAIL_API_TOKEN="your_api_token_here"
   export FASTMAIL_BASE_URL="https://api.fastmail.com"  # optional, defaults to https://api.fastmail.com
   npm start
   

Alternatively, you can run via npx using the GitHub source (no local install required) as described in the README:

Tips and notes:

• Ensure your FASTMAIL_API_TOKEN is kept secret. Do not commit it to version control.
• FASTMAIL_BASE_URL is optional; omit it to use the default Fastmail API endpoint.
• The server uses bearer token authentication against Fastmail’s API via JMAP foundations.
• If you’re testing capabilities, use the provided dry-run or test_bulk_operations tooling where available to avoid unintended changes.
• For deployment, consider proper environment management and rotating API tokens as recommended by Fastmail.
• When using npx deployments, you can pin to a specific release tag for stability (as shown in the README).
• Review the tool list in the README to understand the available capabilities and their parameters (e.g., emailId, mailboxId, query).
• If you expose this server to the internet, implement appropriate network security measures and keep dependencies up to date.