---
slug: "email"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/gabigabogabu/email-mcp-server@main/README.md"
repo: "https://github.com/gabigabogabu/email-mcp-server"
source_file: "README.md"
branch: "main"
---
# 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_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:<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](https://github.com/gabigabogabu/email-mcp-server/tree/HEAD/LICENSE) for details