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.
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
-
Clone the repository:
git clone <repository-url> cd imap-mcp
-
Install dependencies:
npm install
-
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 inboxmailto:<email-address>/folders
- List of email folders/mailboxes
And the following MCP tools:
send_email
- Send an email messagesearch_emails
- Search for emails with advanced query optionslist_folders
- List all available email folders/mailboxes
License
ISC License - see LICENSE for details