IMAP Mini

IMAP Mini MCP is a lightweight MCP server that reads emails from any standard IMAP service and helps you compose draft replies. It operates in read-only mode for most actions, but gives you the ability to create and update draft messages so you can prepare replies without sending or deleting emails.

How to use

To use IMAP Mini MCP with your MCP client, configure a local MCP server entry that runs the Node-based server and connects to your IMAP account. The server exposes a set of email-reading tools and draft creation capabilities that your AI assistant can invoke to prepare replies.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

1. Install dependencies for the server package.

2. Build the server package to generate the distributable code.

3. Run the server directly for development or connect it through an MCP client using the provided configuration.

Notes and configuration

The server is configured in your MCP client with a local command that runs the built server file. You provide the IMAP connection details through environment variables to keep credentials separate from the code.

Tools and capabilities

This MCP exposes tools to list and fetch emails, manage folders, and create or update drafts. Use these tools to build complete draft replies from your AI assistant without sending any messages directly from this server.

Available tools

list_emails_24h

List emails from the last 24 hours, returning count and a list of emails with id, subject, from, and date.

list_emails_7days

List emails from the last 7 days, returning count and a list of emails with id, subject, from, and date.

list_emails_month

List emails from the last 30 days, returning count and a list of emails with id, subject, from, and date.

list_emails_quarter

List emails from the last 90 days, returning count and a list of emails with id, subject, from, and date.

list_emails_year

List emails from the last 365 days, returning count and a list of emails with id, subject, from, and date.

list_emails_all

List all emails, returning count and a list of emails with id, subject, from, and date.

list_emails_from_domain

List all emails from a specific domain, returning count and a list of emails.

list_emails_from_sender

List all emails from a specific sender address, returning count and a list of emails.

fetch_email_content

Fetch full content for a single email by id, returning id, subject, from, to, date, body, and attachments.

fetch_email_attachment

Download a specific attachment from an email by id and attachment_id, returning metadata and content in Base64.

list_folders

List all folders in the email account, returning count and folder metadata.

create_folder

Create a new folder with a full path like INBOX/Receipts and return the created path.

move_email

Move an email from one folder to another without deletion, returning the id and new destination.

create_draft

Create a new draft in the Drafts folder, returning id, subject, to, and date.

draft_reply

Create a reply draft to an existing email, deriving recipient and threading headers, returning id, subject, to, and date.

update_draft

Replace an existing draft in the Drafts folder with new content, returning id, subject, to, and date.