Email MCP Server

A Model Context Protocol (MCP) server for email integration using IMAP and SMTP protocols. This server allows model assistants to access and interact with email accounts.

Features

- Read emails from IMAP mailboxes
- Send emails via SMTP
- Search emails
- List email folders

Prerequisites

- Node.js (v16 or higher)
- npm or yarn
- Email account with IMAP and SMTP access

Setup

1. Clone the repository:

   git clone <repository-url>

   cd imap-mcp

   

2. Install dependencies:

   npm install

   

3. Create a .env file in the root directory with the following variables:

   [email protected]

   EMAIL_PASSWORD=your-password

   IMAP_HOST=imap.example.com

   IMAP_PORT=993

   SMTP_HOST=smtp.example.com

   SMTP_PORT=465

   

Usage

Development

To run the server in development mode:

npm run dev

This will watch for changes, recompile TypeScript, and restart the server automatically.

Production

To build and run the server in production mode:

npm run build
npm start

API

The server exposes the following MCP resources:

- mailto:<email-address>/inbox - List of 10 most recent emails in the inbox
- mailto:<email-address>/folders - List of email folders/mailboxes

And the following MCP tools:

- send_email - Send an email message
- search_emails - Search for emails with advanced query options
- list_folders - List all available email folders/mailboxes

License

ISC License - see LICENSE for details