Email MCP Server logo

Email MCP Server

by gabigabogabu

The Email MCP Server is a Model Context Protocol server designed for email integration. It enables model assistants to interact with email accounts using IMAP and SMTP protocols.

View on GitHub

Last updated: N/A

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