JMAP Email

io.github.mikluko

Email management via JMAP — mailboxes, messages, identities, and Sieve scripts

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.mikluko-jmap-mcp": {4      "command": "docker",5      "args": [6        "run",7        "-i",8        "--rm",9        "ghcr.io/mikluko/jmap-mcp:0.10.0"10      ],11      "env": {12        "JMAP_SESSION_URL": "<value>",13        "JMAP_AUTH_TOKEN": "<secret>"14      }15    }16  }17}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

docker run -i --rm ghcr.io/mikluko/jmap-mcp:0.10.0

Credentials from the publisher

JMAP_SESSION_URL — JMAP session endpoint URL (e.g. https://api.fastmail.com/jmap/session)
JMAP_AUTH_TOKEN — JMAP bearer token for authentication

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1JMAP_SESSION_URL=<value> JMAP_AUTH_TOKEN=<secret> claude mcp add io.github.mikluko-jmap-mcp -- docker run -i --rm ghcr.io/mikluko/jmap-mcp:0.10.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.mikluko-jmap-mcp": {4      "command": "docker",5      "args": [6        "run",7        "-i",8        "--rm",9        "ghcr.io/mikluko/jmap-mcp:0.10.0"10      ],11      "env": {12        "JMAP_SESSION_URL": "<value>",13        "JMAP_AUTH_TOKEN": "<secret>"14      }15    }16  }17}

claude_desktop_config.json

Local · ociPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.10.0
API key: JMAP_SESSION_URL, JMAP_AUTH_TOKEN
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install JMAP Email?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does JMAP Email need an API key?

The publisher lists these environment variables: JMAP_SESSION_URL, JMAP_AUTH_TOKEN.

What transport does JMAP Email use?

JMAP Email runs locally over stdio.

When was JMAP Email last checked?

Last checked 2026-10-28. Email management via JMAP — mailboxes, messages, identities, and Sieve scripts

From the publisher

Documentation

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

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

RFC 8620 — JMAP Core
RFC 8621 — JMAP Mail
RFC 9425 — JMAP Sieve Scripts
MCP Specification

JMAP Email

io.github.mikluko

Email management via JMAP — mailboxes, messages, identities, and Sieve scripts

Communication

Add to Cursor Add to VS Code Run on PlugMCP

GitHub

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.mikluko-jmap-mcp": {4      "command": "docker",5      "args": [6        "run",7        "-i",8        "--rm",9        "ghcr.io/mikluko/jmap-mcp:0.10.0"10      ],11      "env": {12        "JMAP_SESSION_URL": "<value>",13        "JMAP_AUTH_TOKEN": "<secret>"14      }15    }16  }17}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

docker run -i --rm ghcr.io/mikluko/jmap-mcp:0.10.0

Credentials from the publisher

JMAP_SESSION_URL — JMAP session endpoint URL (e.g. https://api.fastmail.com/jmap/session)
JMAP_AUTH_TOKEN — JMAP bearer token for authentication

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1JMAP_SESSION_URL=<value> JMAP_AUTH_TOKEN=<secret> claude mcp add io.github.mikluko-jmap-mcp -- docker run -i --rm ghcr.io/mikluko/jmap-mcp:0.10.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.mikluko-jmap-mcp": {4      "command": "docker",5      "args": [6        "run",7        "-i",8        "--rm",9        "ghcr.io/mikluko/jmap-mcp:0.10.0"10      ],11      "env": {12        "JMAP_SESSION_URL": "<value>",13        "JMAP_AUTH_TOKEN": "<secret>"14      }15    }16  }17}

claude_desktop_config.json

Local · ociPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.10.0
API key: JMAP_SESSION_URL, JMAP_AUTH_TOKEN
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install JMAP Email?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does JMAP Email need an API key?

The publisher lists these environment variables: JMAP_SESSION_URL, JMAP_AUTH_TOKEN.

What transport does JMAP Email use?

JMAP Email runs locally over stdio.

When was JMAP Email last checked?

Last checked 2026-10-28. Email management via JMAP — mailboxes, messages, identities, and Sieve scripts

From the publisher

Documentation

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

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).

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

RFC 8620 — JMAP Core
RFC 8621 — JMAP Mail
RFC 9425 — JMAP Sieve Scripts
MCP Specification