1
Add it to Claude Code
claude mcp add -e "IMAP_HOST=${IMAP_HOST}" -e "IMAP_PORT=${IMAP_PORT}" -e "IMAP_USERNAME=${IMAP_USERNAME}" -e "IMAP_PASSWORD=${IMAP_PASSWORD}" -e "IMAP_USE_SSL=${IMAP_USE_SSL}" imap-mcp-9c7b -- npx imap-mcpRequired:
IMAP_HOSTIMAP_PORTIMAP_USERNAMEIMAP_PASSWORDIMAP_USE_SSL2
Make your agent remember this setup
imap-mcp-9c7b's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Create draft emails directly in your IMAP server's drafts folder
- Connect to any IMAP-compatible email provider like Gmail or Outlook
- Secure credential management via environment variables
- Full TypeScript support with type definitions
- Native integration with Claude and other MCP-compatible assistants
Tools 1
create-draftCreates a draft email message and saves it to the IMAP server's drafts folder.Environment Variables
IMAP_HOSTrequiredThe hostname of the IMAP serverIMAP_PORTrequiredThe port number for the IMAP serverIMAP_USERNAMErequiredThe username for email authenticationIMAP_PASSWORDrequiredThe password for email authenticationIMAP_USE_SSLrequiredWhether to use SSL for the connection (true or false)Try it
→Create a draft email to my manager with the subject 'Project Update' and tell them the project is on track.
→Draft an email to [email protected] regarding the meeting reminder for tomorrow at 2 PM.
→Please draft an email to [email protected] asking about my recent billing inquiry.
Original README from dominik1001/imap-mcp
imap-mcp
📧 An IMAP Model Context Protocol (MCP) server to expose IMAP operations as tools for AI assistants.
✨ 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": "[email protected]",
"subject": "Meeting Reminder",
"body": "Don't forget about our meeting tomorrow at 2 PM.",
"from": "[email protected]"
}
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