Skip to main content
Glama
deenesjakoruzh
davidvornholt

mail-mcp

by davidvornholt
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

mailbox

Built on davidvornholt/standards.

mailbox is a command-line tool for AI agents to search, read, and draft email in IMAP accounts. It works with any IMAP server that accepts a password or app password. It never sends mail: drafts go to the account's drafts folder, where you review and send them from your mail client.

Install

bun install
just install

This builds a standalone binary to ~/.local/bin/mailbox and installs the agent skill to ~/.agents/skills/mailbox, where Codex and Claude Code find it. Run it again after pulling changes.

Related MCP server: imap-mcp

Configure

Copy apps/cli/accounts.example.toml to ~/.config/mailbox/accounts.toml (or set MAILBOX_CONFIG) and add one [[accounts]] block per account. Then store each password in the OS keyring and check that every account logs in:

mailbox login
mailbox status

mailbox login checks each password against the server before storing it under the keyring service mailbox. On Linux this needs a running Secret Service provider such as gnome-keyring.

Use

Run mailbox --help for the commands and mailbox <command> --help for their options. The skill in apps/cli/skills/mailbox tells agents how to draft and reply.

Develop

bun run check runs the standards drift check, lint, type checks, tests, and the build. It must pass before a change is done. Run the command from source with bun apps/cli/src/app/cli.ts.

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

ActivityActive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • IMAP Mini MCP

    florianbuetow
    F
    license
    A
    quality
    D
    maintenance
    A lightweight MCP server for interacting with IMAP email accounts to read messages, manage folders, and compose draft replies. It supports standard providers and local bridges, providing tools for searching, fetching attachments, and organizing mailboxes without the ability to send or delete emails.
    19
    10
    -

  • imap-mcp

    aviman1109
    F
    license
    Not graded
    quality
    D
    maintenance
    An IMAP client MCP server for reading mail from Dovecot or Synology MailPlus mailboxes, with optional webhook triggers for new messages. It provides tools for managing emails and automates workflows by firing webhooks when matching messages arrive.
    -

  • @aiwerk/mcp-server-imap

    AIWerk
    A
    license
    B
    quality
    C
    maintenance
    Universal IMAP/SMTP MCP server that works with any email provider, providing tools to read, search, send, and manage emails.
    10
    125 npm
    1
    MIT

  • owlpost

    smankoo
    A
    license
    Not graded
    quality
    D
    maintenance
    A high-fidelity IMAP/SMTP MCP server that enables reading, searching, and sending emails from providers like iCloud and Gmail, handling real-world IMAP quirks automatically.
    1
    MIT