Email MCP Server
This project is a modular, type-safe Email Management Context Protocol (MCP) server built with Node.js and TypeScript. It provides a set of tools and controllers for interacting with email servers using the IMAP protocol, supporting operations such as listing folders, retrieving messages, searching, moving, deleting, and managing message flags.
Features
- IMAP Email Operations: Connect to IMAP servers to list folders, fetch messages, search, move, delete, and manage flags.
- Type Safety: All models and data structures are defined using Zod schemas for runtime validation and TypeScript type inference.
- MCP Tools: Implements the fastmcp Tool interface for modular, composable email operations.
- Configurable: Email server configuration is loaded from a config file or environment variables.
- Extensible: Easily add support for POP, SMTP, or JMAP protocols by extending the models and controllers.
Project Structure
src/models/— Zod schemas and types for email data structures (MailItem, MailFolder, EmailAddress, etc.)src/controllers/— Controllers for IMAP and other protocolssrc/tools/— Individual MCP tools for each email operationsrc/index.ts— Entry point, config loading, and tool registration
Getting Started
- Install dependencies:
npm install - Configure your email server settings in
config.jsonor.env. - Run the server or use the tools as needed.
Todo
- IMAP functions
- POP functions
- SMTP functions
- JMAP functions
License
MIT