Skip to main content
Glama
Sign In
jmap-mcp

jmap-mcp

by BryanBerger98
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

@bryanberger/jmap-mcp

Local MCP server that exposes a Stalwart mail server's JMAP surface to an AI assistant, with no data leaving your machine except the exchange with your own server.

What it covers

  • Mail: search, read, fetch attachments, compose, send, file and delete messages, manage folders.

  • Contacts: search and read cards, write them, manage address books.

  • Calendar: search and read events, check availability, create, correct, answer and delete.

  • Files: browse, fetch to disk, upload from disk, organize and delete.

  • Sieve: list scripts, store one, choose which one filters, manage the vacation response.

  • Sharing: read who an object is open to, grant and revoke rights, dismiss notifications.

Thirty tools in all, described one by one in the tools reference.

Related MCP server: Fastmail MCP Server (Unofficial)

Quick start with Claude Code

You need the URL of your server's JMAP session and a bearer token it accepts, obtained as the token page describes.

claude mcp add jmap --transport stdio --scope user \
  --env JMAP_SESSION_URL=https://mail.example.com/.well-known/jmap \
  --env JMAP_BEARER_TOKEN=API_xxx \
  -- npx -y @bryanberger/jmap-mcp

Claude Desktop and Cursor take the same server through a JSON file; see the documentation.

Write policy

Every call is classified from its arguments into one of four classes: read, draft, send, destroy. Each class has a level, allow, confirm or deny, and by default send and destroy are confirmed before they run. A confirmation is a question asked through your MCP client, which must support elicitation; when it does not, the call is refused rather than run silently. The question names what the call is about to do: the recipients, the messages, the rights, the script. The write policy page explains the whole mechanism and how to tune it.

Documentation

Page

Answers

Getting a token from Stalwart

Which bearer the server accepts, and how to check it

Claude Code, Claude Desktop, Cursor

How to register the server in each client

Configuration

Every key and variable, with its default

Tools

What each of the thirty tools does, and when it asks

Limits

Every ceiling, and what happens past it

Write policy

Classes, levels, confirmation, recipient perimeter

Troubleshooting

What a refusal or a startup error means

The documentation lives on GitHub and is not shipped in the npm package.

Development

Requires Node 24 (nvm use) and pnpm.

pnpm install
pnpm typecheck   # tsc, native Go compiler
pnpm test        # vitest
pnpm lint        # biome
pnpm build       # emits dist/

Architecture, decisions and the full file tree live in aidd_docs/INSTALL.md. Contribution workflow in CONTRIBUTING.md.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Fastmail MCP Server

      MattiaHunt4826
      F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and manage email, contacts, and calendar data, including sending/reply, search, attachments, drafts, labels, and CalDAV events.
      -

    • Fastmail MCP Server

      leonietrinh
      F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to read, search, send, draft, reply to, and organize email, manage contacts, and handle calendar events through the JMAP and CalDAV APIs. It also supports attachments, bulk operations, mailbox/label management, and account statistics.
      -

    • Fastmail MCP Server

      Vandenberg42544
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to manage email, contacts, and calendar data through JMAP, CalDAV, and WebDAV APIs, including sending, replying, searching, attachments, labels, and bulk operations.
      MIT