How do I use agent-jmap-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agent-jmap-mcp Find the latest email from Alice and summarize it" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

agent-jmap-mcp

by ericmaddox

Overview Schema Related Servers Score Discussions

Python

Remote

agent-jmap-mcp

PyPI Version Python Version License: MIT MCP Protocol Ruff

A stateless, production-grade JSON Meta Application Protocol (JMAP) client and Model Context Protocol (MCP) server for AI agents, automation pipelines, and developer workflows.

Compliant with RFC 8620 (JMAP Core) and RFC 8621 (JMAP Mail), agent-jmap-mcp allows language models (e.g. Claude, Hermes Agent, GPT-4, Cursor) to inspect mailboxes, search and retrieve messages, navigate conversation threads, download attachments, perform automated inbox triage, and compose/send emails atomically over pure HTTP.

Architecture

flowchart TD
    subgraph Host["AI Agent / Host Application"]
        Agent["AI Agent / LLM Client"]
    end

    subgraph MCP["agent-jmap-mcp Server"]
        Server["FastMCP stdio Engine"]
        Tools["Tools Interface<br/>(list, search, get, thread, download, send, triage)"]
        TriageEng["Rule-Based Triage Engine"]
        Converter["HTML-to-Markdown Engine"]
        Client["RFC 8620/8621 JMAP Client"]
    end

    subgraph Upstream["JMAP Email Server"]
        JMAPEndpoint["JMAP API Endpoint<br/>(Fastmail / Stalwart / Cyrus)"]
    end

    Agent <-->|"JSON-RPC / stdio"| Server
    Server --> Tools
    Tools --> TriageEng
    Tools --> Converter
    Tools --> Client
    Client <-->|"Stateless HTTPS (JSON Batches / Binary Streams)"| JMAPEndpoint

Related MCP server: mcp-imap

Key Capabilities

Stateless HTTP Architecture: Operates over standard HTTPS with bearer token authentication. Avoids persistent IMAP socket overhead and connection timeout state.
Atomic Operations: Executes message creation and dispatch in a single atomic transaction combining Email/set and EmailSubmission/set.
Conversation Threading (Thread/get): Full RFC 8621 conversation thread retrieval aggregating multi-turn email dialogues chronologically.
Binary Attachment Downloads: High-speed streaming downloads for PDF, image, and data attachments via session downloadUrl.
Rich HTML-to-Markdown Extraction: Automated markdown conversion for HTML-only newsletters and styled emails.
Session Auto-Discovery: Automatically queries /.well-known/jmap to discover API endpoints, upload/download URLs, and primary account IDs.
Zero-Footprint Model Context: Optimized JSON payloads structured specifically for minimal LLM context window consumption.
Automated Inbox Triage: Built-in heuristic classification for inbox sorting (Urgent, Action Required, Personal, Notifications, Newsletters).
Universal MCP Compatibility: Plugs directly into Claude Desktop, Hermes Agent, Cursor, Zed, and any MCP-compliant environment.

Installation

Using uv (Recommended)

uv tool install agent-jmap-mcp

Using pipx or pip

pipx install agent-jmap-mcp
# or
pip install agent-jmap-mcp

Configuration

Set the required environment variables:

Variable	Description	Example / Default
`JMAP_SESSION_URL`	JMAP Session discovery URL	`https://api.fastmail.com/.well-known/jmap`
`JMAP_API_TOKEN`	Bearer API token	`fmu1-...`
`JMAP_ACCOUNT_ID`	Optional target account ID	Auto-discovered from session if omitted

A .env.example template is provided in the repository.

MCP Server Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jmap": {
      "command": "uvx",
      "args": ["agent-jmap-mcp"],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/.well-known/jmap",
        "JMAP_API_TOKEN": "YOUR_JMAP_API_TOKEN"
      }
    }
  }
}

Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  jmap:
    command: "uvx"
    args: ["agent-jmap-mcp"]
    env:
      JMAP_SESSION_URL: "https://api.fastmail.com/.well-known/jmap"
      JMAP_API_TOKEN: "${JMAP_API_TOKEN}"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "jmap": {
      "command": "uvx",
      "args": ["agent-jmap-mcp"],
      "env": {
        "JMAP_SESSION_URL": "https://api.fastmail.com/.well-known/jmap",
        "JMAP_API_TOKEN": "YOUR_JMAP_API_TOKEN"
      }
    }
  }
}

Zed Editor

Add to settings.json:

{
  "context_servers": {
    "jmap": {
      "command": {
        "path": "uvx",
        "args": ["agent-jmap-mcp"],
        "env": {
          "JMAP_SESSION_URL": "https://api.fastmail.com/.well-known/jmap",
          "JMAP_API_TOKEN": "YOUR_JMAP_API_TOKEN"
        }
      }
    }
  }
}

Available MCP Tools

Tool Name	Parameters	Description
`jmap_list_mailboxes`	None	Returns metadata for all mailboxes (IDs, names, roles, unread/total counts).
`jmap_list_emails`	`mailbox`, `limit`, `unread_only`, `query`, `from_address`, `subject_contains`	Queries email headers with filtering, search conditions, and sorting.
`jmap_get_email`	`email_id` (str), `mark_as_read` (bool)	Fetches full email body (converted to markdown if HTML), headers, and attachments.
`jmap_get_thread`	`thread_id` (str)	Fetches full multi-message conversation thread chronologically.
`jmap_download_attachment`	`blob_id` (str), `filename` (str), `save_directory` (str)	Downloads binary attachment from JMAP server and saves to disk.
`jmap_send_email`	`to` (list), `subject` (str), `body` (str), `from_address` (str), `cc` (list), `bcc` (list), `draft_only` (bool)	Atomically creates and submits an outgoing message (or saves to drafts).
`jmap_triage_inbox`	`mailbox` (str), `limit` (int), `unread_only` (bool)	Analyzes recent messages and returns categorization, priorities, and action items.

Command Line Interface (CLI)

The package includes a standalone CLI tool agent-jmap:

# Start MCP server over stdio
agent-jmap serve

# List available mailboxes
agent-jmap mailboxes

# List recent emails
agent-jmap list --limit 10
agent-jmap list --unread --query "invoice"

# View specific email
agent-jmap get <email-id>

# View entire conversation thread
agent-jmap thread <thread-id>

# Download binary attachment
agent-jmap download <blob-id> --name report.pdf --output ./downloads

# Run inbox triage
agent-jmap triage --limit 20

# Send email from command line
agent-jmap send --to user@example.com --subject "Status Update" --body "Processing completed."

Development and Testing

Setup Environment

git clone https://github.com/ericmaddox/agent-jmap-mcp.git
cd agent-jmap-mcp
uv sync --extra dev

Running Test Suite

uv run pytest -v

Code Formatting and Linting

uv run ruff check .
uv run ruff format .

Building Distribution Packages

uv build

RFC Compliance

License

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityNo data

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

email A
dev.primitive
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email Communication
302
AgentMailOAuth
to.agentmail
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Email Communication
2
email-agentOAuth
dev.mailkite
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
Email Communication
2
Lockally EmailOAuth
com.lockally
Stateful email for AI agents — read inboxes, reply in-thread, draft with approval.
Email Communication
1

Related MCP Servers

IMAP Email MCP Server
Communication App Automation
jdickey1
A
license
A
quality
F
maintenance
Enables AI assistants to read, search, compose, and send emails by connecting to any IMAP/SMTP provider. It supports comprehensive mailbox management, including draft handling and message deletion, directly through natural language.
Updated 8 months ago (2026-01-13 02:52 UTC)
10
219
10
MIT
mcp-imap
Email Communication
andrewmalov
A
license
Not graded
quality
D
maintenance
Enables AI agents to interact with email accounts via IMAP and SMTP, supporting mailbox listing, email search, retrieval, sending, and management.
Updated 8 months ago (2026-01-07 19:13 UTC)
MIT
Mail MCP Server
Email Communication
martinzarfl
A
license
B
quality
D
maintenance
Enables AI assistants to send, read, and manage emails via SMTP and IMAP, with support for attachments, threads, and mailbox organization.
Updated 10 months ago (2025-11-19 11:53 UTC)
16
42
1
MIT
fastmail-mcp
Email Communication
eduardobrito21
A
license
A
quality
D
maintenance
Enables AI assistants to manage Fastmail email accounts via JMAP, including reading, sending, organizing emails, and handling mailboxes, drafts, and masked emails.
Updated 5 months ago (2026-03-24 18:53 UTC)
43
MIT

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ericmaddox/agent-jmap-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

agent-jmap-mcp

Architecture

Key Capabilities

Installation

Using uv (Recommended)

Using pipx or pip

Configuration

MCP Server Integration

Claude Desktop

Hermes Agent

Cursor

Zed Editor

Available MCP Tools

Command Line Interface (CLI)

Development and Testing

Setup Environment

Running Test Suite

Code Formatting and Linting

Building Distribution Packages

RFC Compliance

License

Tool Schema Changelog

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

IMAP Email MCP Server

mcp-imap

Mail MCP Server

fastmail-mcp

Latest Blog Posts

MCP directory API