
imap-mcp
io.github.langmail/imap-mcp
IMAP email as MCP tools: create draft messages in the Drafts folder of any IMAP mailbox.
Documentation
imap-mcp
📧 An IMAP Model Context Protocol (MCP) server to expose IMAP operations as tools for AI assistants.
Maintained by the team behind Langmail. Want mail, calendar and contacts for your agent over one hosted MCP, with OAuth and nothing to run? → langmail.me
✨ Features
- Email Draft Creation: Create draft emails that are saved to your IMAP server's drafts folder
- IMAP Integration: Connect to any IMAP-compatible email server (Gmail, Outlook, etc.)
- Secure Authentication: Uses environment variables for secure credential management
- MCP Compatible: Works with Claude and other AI assistants that support the Model Context Protocol
- TypeScript: Full TypeScript support with proper type definitions
Setup
{
"mcpServers": {
...,
"imap": {
"command": "npx",
"args": [
"imap-mcp"
],
"env": {
"IMAP_HOST": "<IMAP host>",
"IMAP_PORT": "<IMAP port>",
"IMAP_USERNAME": "<IMAP username>",
"IMAP_PASSWORD": "<IMAP password>",
"IMAP_USE_SSL": "<true or false>"
}
}
}
}
Usage
- Compile TypeScript to JavaScript:
npx tsc
- Run the MCP server:
node dist/index.js
Available Tools
create-draft
Creates a draft email message and saves it to the IMAP server's drafts folder.
Parameters:
to(string, required): The recipient's email addresssubject(string, required): The email subject linebody(string, required): The email body contentfrom(string, optional): The sender's email address (defaults to IMAP_USERNAME)
Example:
{
"to": "recipient@example.com",
"subject": "Meeting Reminder",
"body": "Don't forget about our meeting tomorrow at 2 PM.",
"from": "sender@example.com"
}
The tool will attempt to save the draft to either "INBOX.Drafts" or "Drafts" folder, depending on your email server's folder structure.
License
MIT
imap-mcpnpm install imap-mcpRelated Servers
io.github.langmail/caldav-mcp
CalDAV calendar operations (list, create, update, delete events) as MCP tools.
io.github.langmail/carddav-mcp
CardDAV contacts as MCP tools: list address books; list, get, create, update and delete contacts.
io.github.langmail/langmail-mcp
Self-hosted MCP server for Stalwart: email, calendar and contacts over JMAP, CalDAV and CardDAV.