Claude MarketplacesSubmit

IMAP Mail

buzzer/imap-mcp

Read and search IMAP mailboxes and create drafts. Sending and deleting are not possible.

tools: 7
auth: Secret needed
transport: STDIO
env vars: 10
last updated: Nov 10, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

list_accountsLists the configured mail accounts.

Lists the configured mail accounts.

No parameter schema in public metadata yet.

list_foldersLists the mailbox folders of an account.

Lists the mailbox folders of an account.

No parameter schema in public metadata yet.

list_messagesLists message headers in a folder without changing any flags.

Lists message headers in a folder without changing any flags.

No parameter schema in public metadata yet.

search_messagesSearches messages in a folder; headers only, no flags are changed.

Searches messages in a folder; headers only, no flags are changed.

No parameter schema in public metadata yet.

read_messageReturns the content of a message, optionally setting the \Seen flag.

Returns the content of a message, optionally setting the \Seen flag.

No parameter schema in public metadata yet.

mark_readSets the \Seen flag on a message.

Sets the \Seen flag on a message.

No parameter schema in public metadata yet.

create_draftStores a draft in the drafts folder, optionally with attachments from ATTACHMENT_DIR.

Stores a draft in the drafts folder, optionally with attachments from ATTACHMENT_DIR.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

IMAP_HOST*

IMAP server host name (IMAPS), e.g. imap.example.com

MAIL_USER*

IMAP login, usually the mail address

MAIL_PASSWORD*secret

IMAP password; an app-specific password where the provider requires one

IMAP_PORTdefault: 993

IMAPS port

MAIL_ADDRESS

Own sender address, if it differs from the login

MAIL_FROM_NAME

Display name used as sender of drafts

MAIL_ALIASES

Additional allowed sender addresses, comma-separated; *@example.com allows a whole domain

DRAFTS_FOLDER

Drafts folder, if it is not detected automatically

MARK_READ_ON_READdefault: false

read_message marks every message it returns as read

BCC_SELFdefault: false

Add the sender address as Bcc to every draft

Readme

imap-mcp

A small MCP server that gives an AI assistant (e.g. Claude Desktop) read access to IMAP mailboxes and the ability to create drafts. It was written for a Hetzner mailbox plus an iCloud account on a Raspberry Pi, but it works with any IMAP server that supports IMAPS (port 993).

Status: a personal project, published as-is. It is meant for a trusted home network, not for the open internet. See Security and SECURITY.md.

If you found this server through a registry listing or a third-party marketplace, read this before entering credentials. Use an app-specific password instead of your main password where your provider offers one. The server, and the assistant using it, can see the full content of every mailbox you configure. Mail content is untrusted and can contain prompt injection, so always review drafts yourself before sending them. Do not expose the HTTP transport to the internet.

What it does

View the full README on GitHub

Details

Repository: github.com/buzzer/imap-mcp
Category: Search & Web Crawling
Package: ghcr.io/buzzer/imap-mcp:0.2.0
Transport: STDIO
Auth: Required
Registry: MCP registry, active