https://github.com/gabigabogabu/email-mcp-server
Model Context Protocol Server with IMAP and SMTP connectivity
https://github.com/gabigabogabu/email-mcp-server
anthropic claude imapflow mcp mcp-server node nodemailer typescript
Last synced: 8 months ago
JSON representation
Model Context Protocol Server with IMAP and SMTP connectivity
- Host: GitHub
- URL: https://github.com/gabigabogabu/email-mcp-server
- Owner: gabigabogabu
- License: isc
- Created: 2025-04-02T07:10:56.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-04-02T07:18:40.000Z (8 months ago)
- Last Synced: 2025-04-02T08:25:54.826Z (8 months ago)
- Topics: anthropic, claude, imapflow, mcp, mcp-server, node, nodemailer, typescript
- Language: JavaScript
- Homepage:
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **email-mcp-server** - A simple mcp server that lets your AI agent send emails and attach files through SMTP. `typescript` `anthropic` `claude` `imapflow` `mcp` `npm install gabigabogabu/email-mcp-server` (🤖 AI/ML)
README
# 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
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:/inbox` - List of 10 most recent emails in the inbox
- `mailto:/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](LICENSE) for details