Imap Mcp

What is Imap Mcp about?

Imap Mcp provides a Model Context Protocol (MCP) server that maps common IMAP actions—such as creating draft emails—to callable tools for AI assistants. By connecting to any IMAP‑compatible mailbox, the server lets AI agents read, write, and manage email drafts directly from their context.

How to use Imap Mcp?

1. Configure environment variables for your IMAP host, port, username, password, and SSL flag.
2. Compile the TypeScript source: npx tsc.
3. Start the server: node dist/index.js (or invoke via the MCP‑server configuration using npx imap-mcp).
4. Call the create-draft tool from an AI assistant, passing to, subject, body, and optionally from.

Key Features

• Draft email creation saved to the server's Drafts folder.
• Works with any IMAP‑compatible provider (Gmail, Outlook, etc.).
• Secure credential handling through environment variables.
• Fully typed TypeScript codebase.
• MCP compatible, ready for Claude and other assistants supporting the protocol.

Use Cases

• Automating meeting reminders or follow‑up emails from AI chatbots.
• Enabling AI‑driven personal assistants to draft responses without user intervention.
• Integrating email drafting into workflow automation pipelines.
• Providing a sandboxed email interface for AI research projects.

FAQ

Q: Do I need a special IMAP server? A: No, any standard IMAP server works as long as you provide correct credentials.

Q: Which folder does the draft get saved to? A: The server attempts INBOX.Drafts first, falling back to Drafts if the former does not exist.

Q: Can I send the draft after creation? A: Imap Mcp currently only creates drafts; sending can be performed by another tool or client.

Q: How is authentication handled? A: Credentials are read from environment variables (IMAP_HOST, IMAP_PORT, IMAP_USERNAME, IMAP_PASSWORD, IMAP_USE_SSL).

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

1. Compile TypeScript to JavaScript:

npx tsc

2. 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 address
• subject (string, required): The email subject line
• body (string, required): The email body content
• from (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