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:
- Configure your email server settings in
config.json
or.env
. - Run the server or use the tools as needed.
Todo
- IMAP functions
- POP functions
- SMTP functions
- JMAP functions
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables interaction with email servers through IMAP protocol for managing emails, folders, and messages. Supports operations like listing folders, retrieving messages, searching, moving, deleting, and managing flags with type-safe validation.
Related MCP Servers
- -securityAlicense-qualityIntegrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.Last updated -2GPL 3.0
- -securityAlicense-qualityEnables interaction with Gmail through the Gmail API to read, send, and manage emails. Supports multiple Gmail accounts with real-time monitoring and advanced features for email search and attachment handling.Last updated -13Apache 2.0
- AsecurityAlicenseAqualityProvides IMAP and SMTP capabilities, enabling developers to manage email services with seamless integration and automated workflows.Last updated -473BSD 3-Clause
- AsecurityAlicenseAqualityManage your emails effortlessly with a standardized interface for drafting, sending, retrieving, and organizing messages. Streamline your email workflow with complete Gmail API coverage, including label and thread management.Last updated -6415629MIT License