Skip to main content
Glama
mikluko

jmap-mcp

by mikluko
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Go
Remote

jmap-mcp

MCP server exposing JMAP email and Sieve script operations as tools.

Built with the Go MCP SDK (go-sdk) and go-jmap library.

Tools

Tools map closely to JMAP methods. Email mutation tools provide structured convenience wrappers over Email/set patches.

Mailbox (RFC 8621)

Tool

JMAP Method

Description

mailbox_get

Mailbox/get

Get mailboxes by ID, or list all

mailbox_set

Mailbox/set

Create, update, or destroy mailboxes

Email (RFC 8621)

Tool

JMAP Method

Description

email_query

Email/query

Search emails with filters, returns IDs and total count

email_get

Email/get

Get full content of emails by ID

email_create

Email/set

Create a new email draft in the Drafts mailbox

email_move

Email/set

Move emails to a different mailbox

email_flag

Email/set

Set or remove flags (seen, flagged, answered, draft)

email_delete

Email/set

Delete emails (move to Trash or permanently destroy)

email_attachment_url

Blob download

Signed URL streaming an attachment, expires in 30 s (HTTP mode only)

Identity

Tool

JMAP Method

Description

identity_get

Identity/get

List sender identities (email addresses)

Submission (feature-gated)

Tool

JMAP Method

Description

email_submission_set

EmailSubmission/set

Submit a draft for delivery (requires -enable-send)

Sieve Scripts (RFC 9661, feature-gated)

Tool

JMAP Method

Description

sieve_get

SieveScript/get

List all scripts, or get one with full content (requires -enable-sieve)

sieve_set

SieveScript/set

Create, update, or destroy Sieve scripts (requires -enable-sieve)

sieve_validate

SieveScript/validate

Validate a Sieve script without saving (requires -enable-sieve)

Related MCP server: mail-mcp

Configuration

Env var

Required

Description

JMAP_SESSION_URL

always

JMAP session endpoint (e.g. https://api.fastmail.com/jmap/session)

JMAP_AUTH_TOKEN

stdio mode

Bearer token for JMAP authentication

ATTACHMENT_URL_SECRET

no

Secret sealing signed attachment URLs; set for multi-replica deployments (default: random per-process key)

Flag

Default

Description

-mode

stdio

Server mode: stdio or http

-listen

:8080

HTTP listen address (http mode only)

-enable-send

false

Enable the email_submission_set tool (off by default)

-enable-sieve

false

Enable Sieve script tools (off by default, requires JMAP server support)

-external-url

derived

External base URL for signed attachment links; default derives from the request (X-Forwarded-Proto/X-Forwarded-Host aware)

In HTTP mode, the token can be passed per-request via Authorization: Bearer <token> header or jmap_token query parameter (query parameter takes precedence).

In HTTP mode, email_attachment_url returns a link served from /attachments/ that expires 30 seconds after issuance. The link is an AES-GCM sealed capability: it embeds the JMAP token, account, and blob IDs, so the endpoint streams the attachment from the JMAP server without any additional authentication and stores nothing on disk.

Installation

Kubernetes (Helm)

helm install jmap-mcp oci://ghcr.io/mikluko/helm-charts/jmap-mcp \
  --version 0.1.0 \
  --set jmap.sessionURL="https://api.fastmail.com/jmap/session"

In HTTP mode, JMAP auth tokens are passed per-request via Authorization: Bearer header or ?jmap_token= query parameter — no static tokens are stored in the cluster.

Binary

go install github.com/mikluko/jmap-mcp@latest

From source

git clone https://github.com/mikluko/jmap-mcp.git
cd jmap-mcp
make install

Usage

# stdio mode (default)
export JMAP_SESSION_URL=https://api.fastmail.com/jmap/session
export JMAP_AUTH_TOKEN=your-token
./jmap-mcp

# HTTP mode
./jmap-mcp -mode http -listen :8080

Build

make build # Build and push container image + Helm chart
make image # Build and push container image with ko
make package # Package and push Helm chart to OCI registry
make test # Run tests
make install # Install binary locally

References

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Email MCP Server

    chinmay4382
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI models to read, search, and send emails via IMAP and SMTP protocols. It supports various providers like Gmail and Outlook, allowing for tasks such as retrieving unread messages, searching by sender, and managing mailbox folders.
    -

  • mail-mcp

    KpihX
    A
    license
    Not graded
    quality
    D
    maintenance
    A generic IMAP and SMTP MCP server that enables AI agents to interact with email accounts for reading, searching, and sending messages. It provides high-level tools for managing email workflows like daily digests and folder organization across any standard email provider.
    1
    MIT

  • imap-mcp

    twosg
    A
    license
    B
    quality
    B
    maintenance
    An MCP server that exposes IMAP operations as tools for AI assistants, enabling email management including listing mailboxes, reading, searching, moving, flagging emails, and creating drafts.
    7
    23 npm
    MIT

  • imap-smtp-mcp

    DeamonDev888
    A
    license
    Not graded
    quality
    A
    maintenance
    Exposes any IMAP mailbox and SMTP relay as MCP tools, enabling email management (read, search, send, delete) through MCP-compatible agents.
    MIT