Imap Email

jdickey1

MCP server for Claude Code that provides email capabilities through IMAP/SMTP. Read, search, compose, and manage emails from any IMAP provider.

Communication

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "imap-email-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add imap-email-mcp -- npx -y imap-email-mcp@1.0.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "imap-email-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Imap Email?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Imap Email need an API key?

No required environment variable is listed on this record.

What transport does Imap Email use?

Imap Email runs locally over stdio.

When was Imap Email last checked?

Last checked 2026-10-28. MCP server for Claude Code that provides email capabilities through IMAP/SMTP. Read, search, compose, and manage emails from any IMAP provider.

From the publisher

Documentation

IMAP Email MCP Server

A Model Context Protocol (MCP) server that provides email capabilities to Claude Code, Claude Desktop, Cursor, and other MCP-compatible AI tools. Connect to any IMAP/SMTP email provider to read, search, compose, and manage emails directly from your AI assistant.

Quick Start

Claude Code (CLI)

Important: Claude Code CLI uses claude mcp add, not config files.

claude mcp add imap-email -s user \
  -e [email protected] \
  -e IMAP_PASSWORD='your-app-password' \
  -e IMAP_HOST=imap.example.com \
  -- npx -y imap-email-mcp

Note: If your password contains special shell characters (%, ^, *, $, !, etc.), wrap it in single quotes as shown above.

Note: Restart Claude Code after adding an MCP for the new tools to become available.

Verify with:

claude mcp list
claude mcp get imap-email

Remove with:

claude mcp remove imap-email -s user

Cursor

Add new MCP server:

Name: imap-email
Type: command
Command: npx -y imap-email-mcp

Then set environment variables in Cursor's MCP settings:

[email protected]
IMAP_PASSWORD=your-app-password
IMAP_HOST=imap.example.com

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "imap-email": {
      "command": "npx",
      "args": ["-y", "imap-email-mcp"],
      "env": {
        "IMAP_USER": "[email protected]",
        "IMAP_PASSWORD": "your-app-password",
        "IMAP_HOST": "imap.example.com"
      }
    }
  }
}

Features

Read emails - List and read emails from any folder
Search - Search by subject, sender, or body content
Compose - Create and save email drafts
Send - Send emails directly via SMTP
Manage drafts - List, read, update, and delete drafts
Delete emails - Remove unwanted messages
Multi-provider support - Works with Gmail, Outlook, Yahoo, Fastmail, and any standard IMAP provider

Configuration

Required Environment Variables

Variable	Description
`IMAP_USER`	Your email address
`IMAP_PASSWORD`	App password (not your main password!)
`IMAP_HOST`	IMAP server hostname

Optional Environment Variables

Variable	Default	Description
`IMAP_PORT`	`993`	IMAP port
`IMAP_TLS`	`true`	Use TLS
`SMTP_HOST`	Same as IMAP_HOST	SMTP server hostname
`SMTP_PORT`	`465`	SMTP port
`SMTP_SECURE`	`true`	Use secure SMTP

Provider Settings

Provider	IMAP_HOST	SMTP_HOST	Notes
Gmail	`imap.gmail.com`	`smtp.gmail.com`	Create App Password
Outlook	`outlook.office365.com`	`smtp.office365.com`	Use port 587, SMTP_SECURE=false
Yahoo	`imap.mail.yahoo.com`	`smtp.mail.yahoo.com`	Generate App Password in settings
Fastmail	`imap.fastmail.com`	`smtp.fastmail.com`	App Password from Privacy & Security
iCloud	`imap.mail.me.com`	`smtp.mail.me.com`	Generate App Password

Available Tools

Tool	Description
`list_folders`	List all email folders/mailboxes
`list_emails`	List emails with optional filtering
`get_email`	Get full email content by UID
`search_emails`	Search by subject, sender, or body
`list_drafts`	List all draft emails
`get_draft`	Get a specific draft by UID
`create_draft`	Create a new email draft
`update_draft`	Update an existing draft
`send_email`	Send an email directly
`delete_email`	Delete an email by UID

Usage Examples

Once configured, use natural language:

"Check my inbox for unread emails"
"Search for emails from [email protected]"
"Create a draft email to [email protected] about the meeting tomorrow"
"Show me my drafts folder"

Security Best Practices

Use App Passwords - Never use your main account password
Environment Variables - Store credentials in env vars, not in code
Review Before Sending - Use create_draft instead of send_email to review first

Troubleshooting

Authentication failed

Verify your app password is correct
Ensure IMAP access is enabled in your email provider's settings

Drafts folder not found

The server tries common names (Drafts, INBOX.Drafts, [Gmail]/Drafts)
Your provider may use a different folder name

Connection timeout

Check your IMAP_HOST is correct
Verify port 993 is not blocked by firewall

Alternative Installation

Install globally

npm install -g imap-email-mcp
imap-email-mcp

Clone and run

git clone https://github.com/jdickey1/imap-email-mcp.git
cd imap-email-mcp
npm install
node index.js

License

MIT License - see LICENSE for details.

Imap Email

jdickey1

MCP server for Claude Code that provides email capabilities through IMAP/SMTP. Read, search, compose, and manage emails from any IMAP provider.

Communication

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "imap-email-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add imap-email-mcp -- npx -y imap-email-mcp@1.0.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "imap-email-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Imap Email?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Imap Email need an API key?

No required environment variable is listed on this record.

What transport does Imap Email use?

Imap Email runs locally over stdio.

When was Imap Email last checked?

Last checked 2026-10-28. MCP server for Claude Code that provides email capabilities through IMAP/SMTP. Read, search, compose, and manage emails from any IMAP provider.

From the publisher

Documentation

IMAP Email MCP Server

Quick Start

Claude Code (CLI)

Important: Claude Code CLI uses claude mcp add, not config files.

claude mcp add imap-email -s user \
  -e [email protected] \
  -e IMAP_PASSWORD='your-app-password' \
  -e IMAP_HOST=imap.example.com \
  -- npx -y imap-email-mcp

Note: If your password contains special shell characters (%, ^, *, $, !, etc.), wrap it in single quotes as shown above.

Note: Restart Claude Code after adding an MCP for the new tools to become available.

Verify with:

claude mcp list
claude mcp get imap-email

Remove with:

claude mcp remove imap-email -s user

Cursor

Add new MCP server:

Name: imap-email
Type: command
Command: npx -y imap-email-mcp

Then set environment variables in Cursor's MCP settings:

[email protected]
IMAP_PASSWORD=your-app-password
IMAP_HOST=imap.example.com

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "imap-email": {
      "command": "npx",
      "args": ["-y", "imap-email-mcp"],
      "env": {
        "IMAP_USER": "[email protected]",
        "IMAP_PASSWORD": "your-app-password",
        "IMAP_HOST": "imap.example.com"
      }
    }
  }
}

Features

Read emails - List and read emails from any folder
Search - Search by subject, sender, or body content
Compose - Create and save email drafts
Send - Send emails directly via SMTP
Manage drafts - List, read, update, and delete drafts
Delete emails - Remove unwanted messages
Multi-provider support - Works with Gmail, Outlook, Yahoo, Fastmail, and any standard IMAP provider

Configuration

Required Environment Variables

Variable	Description
`IMAP_USER`	Your email address
`IMAP_PASSWORD`	App password (not your main password!)
`IMAP_HOST`	IMAP server hostname

Optional Environment Variables

Variable	Default	Description
`IMAP_PORT`	`993`	IMAP port
`IMAP_TLS`	`true`	Use TLS
`SMTP_HOST`	Same as IMAP_HOST	SMTP server hostname
`SMTP_PORT`	`465`	SMTP port
`SMTP_SECURE`	`true`	Use secure SMTP

Provider Settings

Provider	IMAP_HOST	SMTP_HOST	Notes
Gmail	`imap.gmail.com`	`smtp.gmail.com`	Create App Password
Outlook	`outlook.office365.com`	`smtp.office365.com`	Use port 587, SMTP_SECURE=false
Yahoo	`imap.mail.yahoo.com`	`smtp.mail.yahoo.com`	Generate App Password in settings
Fastmail	`imap.fastmail.com`	`smtp.fastmail.com`	App Password from Privacy & Security
iCloud	`imap.mail.me.com`	`smtp.mail.me.com`	Generate App Password

Available Tools

Tool	Description
`list_folders`	List all email folders/mailboxes
`list_emails`	List emails with optional filtering
`get_email`	Get full email content by UID
`search_emails`	Search by subject, sender, or body
`list_drafts`	List all draft emails
`get_draft`	Get a specific draft by UID
`create_draft`	Create a new email draft
`update_draft`	Update an existing draft
`send_email`	Send an email directly
`delete_email`	Delete an email by UID

Usage Examples

Once configured, use natural language:

"Check my inbox for unread emails"
"Search for emails from [email protected]"
"Create a draft email to [email protected] about the meeting tomorrow"
"Show me my drafts folder"

Security Best Practices

Use App Passwords - Never use your main account password
Environment Variables - Store credentials in env vars, not in code
Review Before Sending - Use create_draft instead of send_email to review first

Troubleshooting

Authentication failed

Verify your app password is correct
Ensure IMAP access is enabled in your email provider's settings

Drafts folder not found

The server tries common names (Drafts, INBOX.Drafts, [Gmail]/Drafts)
Your provider may use a different folder name

Connection timeout

Check your IMAP_HOST is correct
Verify port 993 is not blocked by firewall

Alternative Installation

Install globally

npm install -g imap-email-mcp
imap-email-mcp

Clone and run

git clone https://github.com/jdickey1/imap-email-mcp.git
cd imap-email-mcp
npm install
node index.js

License

MIT License - see LICENSE for details.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Imap Email?

Does Imap Email need an API key?

What transport does Imap Email use?

When was Imap Email last checked?

Documentation

IMAP Email MCP Server

Quick Start

Claude Code (CLI)

Cursor

Claude Desktop

Features

Configuration

Required Environment Variables

Optional Environment Variables

Provider Settings

Available Tools

Usage Examples

Security Best Practices

Troubleshooting

Alternative Installation

Install globally

Clone and run

License

Links

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Imap Email?

Does Imap Email need an API key?

What transport does Imap Email use?

When was Imap Email last checked?

Documentation

IMAP Email MCP Server

Quick Start

Claude Code (CLI)

Cursor

Claude Desktop

Features

Configuration

Required Environment Variables

Optional Environment Variables

Provider Settings

Available Tools

Usage Examples

Security Best Practices

Troubleshooting

Alternative Installation

Install globally

Clone and run

License

Links