wyattjoh/jmap-mcp: 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 jmap-jam client library.

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/jmap-mcp@0.1.1"
      ],
      "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.

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!