email-mcp-server

email-mcp-server

3
communication

The Email MCP Server is a server that facilitates email integration using IMAP and SMTP protocols. It enables model assistants to read, send, search, and list emails from a user's email account.

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_USER=your-email@example.com
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 for details