Is Mcp Mail Server safe to use?

Mcp Mail Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Mcp Mail Server?

Mcp Mail Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Mcp Mail Server do?

Mcp Mail Server provides 24 tools: connect_all, get_connection_status, disconnect_all, open_mailbox, list_mailboxes and 19 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Mcp Mail Server?

Mcp Mail Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is Mcp Mail Server actively maintained?

Mcp Mail Server is recently maintained — last commit was 64 days ago. It has 31 GitHub stars.

Mcp Mail Server

Name: Mcp Mail Server
Author: yunfeizhu

mcp-mail-server · by yunfeizhu

A lightweight Model Context Protocol (MCP) server that provides IMAP and SMTP email functionality for AI assistants like Claude in Cursor IDE. Built with TypeScript and optimized for easy deployment via npm/npx.

31 364/wk 24 tools GitHub npm

No known CVEs

MIT license

Maintained

Last commit 64d ago

Works with most clients

Transport: stdio, http

24 tools · ~1.2k tok

Grade B · 0.6% of 200K ctx

Edit this pageView history

Communication

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-mail-server": {
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "EMAIL_PASS": "your-password",
        "EMAIL_USER": "your-email@domain.com",
        "IMAP_SECURE": "true",
        "SMTP_SECURE": "true"
      },
      "args": [
        "-y",
        "mcp-mail-server"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/mcp-mail-server)](https://mcppedia.org/s/mcp-mail-server)

Read me

What Mcp Mail Server does

A Model Context Protocol server for IMAP/SMTP email operations with Claude, Cursor, and other AI assistants.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'mcp-mail-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

81/100across 5 weighted dimensions

How we score →

0255075100

−19

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mcp-mail-server against OSV.dev.

Inventory

Tools (24)

Click any tool to inspect its schema.

~1.2k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Mcp Mail Server safe to use?: Mcp Mail Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Mcp Mail Server?: Mcp Mail Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Mcp Mail Server do?: Mcp Mail Server provides 24 tools: connect_all, get_connection_status, disconnect_all, open_mailbox, list_mailboxes and 19 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Mcp Mail Server?: Mcp Mail Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Mcp Mail Server actively maintained?: Mcp Mail Server is recently maintained — last commit was 64 days ago. It has 31 GitHub stars.

Similar servers

Others in communication

View all →

Mcp_agent_mail96

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

2.0k 6

Mac_messages_mcp93

An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.

289 4

Agenticmail92

Email & SMS infrastructure for AI agents — send and receive real email and text messages programmatically

133 7

Ms 365 Mcp Server91

A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API

736 22

MCP Security Weekly

Get CVE alerts and security updates for Mcp Mail Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Communication

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-mail-server": {
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "EMAIL_PASS": "your-password",
        "EMAIL_USER": "your-email@domain.com",
        "IMAP_SECURE": "true",
        "SMTP_SECURE": "true"
      },
      "args": [
        "-y",
        "mcp-mail-server"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/mcp-mail-server)](https://mcppedia.org/s/mcp-mail-server)

Read me

What Mcp Mail Server does

A Model Context Protocol server for IMAP/SMTP email operations with Claude, Cursor, and other AI assistants.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'mcp-mail-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

MCP Mail Server

Language: English | 中文

A Model Context Protocol server for IMAP/SMTP email operations with Claude, Cursor, and other AI assistants.

Features

IMAP Operations: Search, read, and manage emails across mailboxes
SMTP Support: Send emails with HTML/text content and attachments
Attachment Management: View attachment metadata and save attachments to local files
Secure Configuration: Environment-based setup with TLS/SSL support
AI-Friendly: Natural language commands for email operations
Auto Connection Management: Automatic IMAP/SMTP connection handling
Multi-Mailbox Support: Access INBOX, Sent, and custom folders

Changelog

[1.2.1] - 2026-03-18

Fixed

Fixed search criteria (FROM/TO/SUBJECT/BODY/KEYWORD/SINCE) not using nested array format, causing errors on TO and other searches
Fixed search() wrapping criteria in an extra array, breaking compound search conditions
Fixed deleteMessage() failing silently when the mailbox was opened in read-only mode
Fixed getRecentMessages() misusing the IMAP RECENT flag; now fetches latest N messages by UID
Fixed getRecentMessages() / getUnseenMessages() relying on leftover mailbox state from previous operations
Fixed cleanReplySubject() only stripping one Re: prefix layer, causing false negatives in unreplied detection
Fixed email date stored as locale string causing inconsistent new Date() parsing across platforms; changed to ISO 8601
Fixed ensureIMAPConnection() having no timeout while waiting for concurrent initialization
Fixed saveSentMessage() always returning sentFolderSaved: true even when save failed
Fixed handleGetMessages() / handleDeleteMessage() relying on currentBox state to locate messages
Fixed reply_to_email writing literal "undefined" into the body when text is empty

Added

All search tools now support an inboxOnly parameter to restrict search to INBOX only

Improved

ensureSMTPConnection() now has concurrency guard with 30-second timeout, consistent with IMAP
Sent mailbox auto-detected via RFC 6154 \Sent special-use attribute with result caching, compatible with all mail providers
saveMessageToFolder() simplified; skips saving if no sent folder is found
Search now uses slice(-limit) to fetch the newest messages first, preventing empty results after date filtering
HTML-escape applied to quoted content in reply emails to prevent XSS injection

For the full version history, see CHANGELOG.md.

Quick Start

Install: npm install -g mcp-mail-server
Configure environment variables (see Configuration)
Add to your MCP client configuration
Use natural language: "Show me unread emails from today"

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "npx",
      "args": ["-y", "mcp-mail-server"],
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASS": "your-password"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "npx",
      "args": ["-y", "mcp-mail-server"],
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMA

... [View full README on GitHub](https://github.com/yunfeizhu/mcp-mail-server#readme)

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

81/100across 5 weighted dimensions

How we score →

0255075100

−19

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mcp-mail-server against OSV.dev.

Inventory

Tools (24)

Click any tool to inspect its schema.

~1.2k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Mcp Mail Server safe to use?: Mcp Mail Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Mcp Mail Server?: Mcp Mail Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Mcp Mail Server do?: Mcp Mail Server provides 24 tools: connect_all, get_connection_status, disconnect_all, open_mailbox, list_mailboxes and 19 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Mcp Mail Server?: Mcp Mail Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Mcp Mail Server actively maintained?: Mcp Mail Server is recently maintained — last commit was 64 days ago. It has 31 GitHub stars.