communication

JMAP (Fastmail)▌

by jahfer

Access Fastmail via JMAP for secure email reading, advanced search, and easy content management. Fastmail login and Gmai

Connects to Fastmail servers via JMAP protocol to enable email reading, searching with advanced filters, and content retrieval for conversational email management.

github stars

★ 5

GitHub npm

Fastmail-specific integrationJMAP protocol support

best for

/ Email automation and processing workflows
/ AI assistants that need email context
/ Email analysis and filtering tools

capabilities

/ Read emails from Fastmail accounts
/ Search emails with advanced filters
/ Retrieve email content and metadata
/ Access email conversations

what it does

Connects to Fastmail's email service via JMAP protocol to read and search your emails through MCP. Requires Fastmail API token for authentication.

about

JMAP (Fastmail) is a community-built MCP server published by jahfer that provides AI assistants with tools and capabilities via the Model Context Protocol. Access Fastmail via JMAP for secure email reading, advanced search, and easy content management. Fastmail login and Gmai It is categorized under communication.

how to install

You can install JMAP (Fastmail) in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

JMAP (Fastmail) is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

JMAP-MCP

Read emails via MCP!

Introduction

JMAP-MCP is a connector designed to interact with a JMAP (JSON Mail Access Protocol) server, allowing you to read emails via the Model Context Protocol (MCP). This project specifically demonstrates integration with a Fastmail JMAP server.

MCP Configuration

To use JMAP-MCP, you need to configure it as an mcpServer in your MCP configuration file. Here is an example configuration:

{
  "mcpServers": {
    "emails": {
      "command": "npx",
      "args": ["-y", "@jahfer/jmap-mcp-server"],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session", // for example
        "JMAP_TOKEN": "<your-jmap-token>"
      }
    }
  }
}

API Token Configuration

You need to set your JMAP API token to authenticate with your email server (e.g., Fastmail). Obtain your API token from your server's settings.

Set the JMAP_SESSION_URL and JMAP_TOKEN environment variables when running the application.

Tools

Once configured in MCP, you can use commands or features within MCP that interact with the server definition to read your emails via the JMAP protocol.

Local Development

Prerequisites: Ensure you have Node.js installed.
Clone the repository: Clone this repository to your local machine.
Install dependencies: Navigate to the project directory and run:
```
npm install
```