A Model Context Protocol (MCP) server that provides tools for interacting with JMAP (JSON Meta Application Protocol) email servers. Built with Deno and using the @htunnicliff/jmap-jam client library.

• Search Emails: Search emails with text queries, sender/recipient filters, date ranges, and keywords
• Get Emails: Retrieve specific emails by ID with full details
• Get Threads: Retrieve email threads (conversation chains)
• Mark Emails: Mark emails as read/unread, flagged/unflagged
• Move Emails: Move emails between mailboxes
• Delete Emails: Delete emails permanently

• Get Mailboxes: List all mailboxes/folders with hierarchy support

• Send Email: Compose and send new emails with support for plain text and HTML
• Reply to Email: Reply to existing emails with reply-all support

• Full JMAP RFC 8620/8621 compliance via jmap-jam
• Comprehensive input validation with Zod schemas
• Pagination support for all list operations
• Rich error handling and connection management
• Functional programming patterns throughout
• TypeScript support with strong typing

• Deno v1.40 or later
• A JMAP-compliant email server (e.g., Cyrus IMAP, Stalwart Mail Server, FastMail)
• Valid JMAP authentication credentials

Add the following to your agent of choice:

{
  "mcpServers": {
    "fastmail": {
      "type": "stdio",
      "command": "deno",
      "args": [
        "run",
        "--allow-net=api.fastmail.com",
        "--allow-env=JMAP_SESSION_URL,JMAP_BEARER_TOKEN,JMAP_ACCOUNT_ID",
        "jsr:@wyattjoh/[email protected]"
      ],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session",
        "JMAP_BEARER_TOKEN": "API_TOKEN"
      }
    }
  }
}

Search for emails with various filters.

Parameters:

• query (optional): Text search query
• from (optional): Filter by sender email address
• to (optional): Filter by recipient email address
• subject (optional): Filter by subject text
• inMailbox (optional): Search within specific mailbox
• hasKeyword (optional): Filter by keyword (e.g., '$seen', '$flagged')
• notKeyword (optional): Exclude by keyword
• before (optional): Only emails before date (ISO datetime)
• after (optional): Only emails after date (ISO datetime)
• limit (optional): Max results (1-100, default: 50)
• position (optional): Starting position for pagination (default: 0)

Retrieve specific emails by their IDs.

Parameters:

• ids: Array of email IDs (1-50 IDs)
• properties (optional): Specific properties to return

Get list of mailboxes/folders.

Parameters:

• parentId (optional): Filter by parent mailbox
• limit (optional): Max results (1-200, default: 100)
• position (optional): Starting position for pagination

Get email threads by their IDs.

Parameters:

• ids: Array of thread IDs (1-20 IDs)

Mark emails with keywords (read/unread, flagged/unflagged).

Parameters:

• ids: Array of email IDs (1-100 IDs)
• seen (optional): Mark as read (true) or unread (false)
• flagged (optional): Mark as flagged (true) or unflagged (false)

Move emails to a different mailbox.

Parameters:

• ids: Array of email IDs (1-100 IDs)
• mailboxId: Target mailbox ID

Delete emails permanently.

Parameters:

• ids: Array of email IDs (1-100 IDs)

Send a new email.

Parameters:

• to: Array of recipients with name and email
• cc (optional): Array of CC recipients
• bcc (optional): Array of BCC recipients
• subject: Email subject
• textBody (optional): Plain text body
• htmlBody (optional): HTML body
• identityId (optional): Identity to send from

Reply to an existing email.

Parameters:

• emailId: ID of email to reply to
• replyAll (optional): Reply to all recipients (default: false)
• subject (optional): Custom reply subject
• textBody (optional): Plain text body
• htmlBody (optional): HTML body
• identityId (optional): Identity to send from

This server should work with any JMAP-compliant email server, including:

deno run --allow-env --allow-net --watch src/mod.ts

# Test connection
deno run --allow-env --allow-net src/mod.ts

The server is built using:

• All input is validated using Zod schemas
• Environment variables are used for sensitive configuration
• No secrets are logged or exposed in responses
• Follows JMAP security best practices

1. Fork the repository
2. Create a feature branch
3. Make changes following the functional programming style
4. Test your changes thoroughly
5. Submit a pull request

MIT License - see LICENSE file for details.