jahfer/jmap-mcp-server

5 stars 4 forks Quality 56 Trend 13MIT

MCP Server for JMAP (Fastmail) over stdio

Overview

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. To use JMAP-MCP, you need to configure it as an mcpServer in your MCP configuration file. Here is an example 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. 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. 1. : Ensure you have Node.js installed. 2. : Clone this repository to your local machine. 3. : Navigate to the project directory and run:

README

JMAP-MCP

Read emails via MCP!

Introduction

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": ""
      }
    }
  }
}

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
```

View the full README on GitHub

Install

npx -y @jahfer/jmap-mcp-server

New to MCP? Start with the mcpskill.org guide →

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>"
      }
    }
  }
}