MCP Email Reader

@karateboss

Basic information

About MCP Email Reader

Model Context Protocol (MCP) server to connect to an email server and to read emails

MCP Email Reader config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_email_reader": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/karateboss/mcp_email_reader@main",
        "mcp_email_reader"
      ],
      "env": {
        "IMAP_SERVER": "",
        "EMAIL_ACCOUNT": "",
        "EMAIL_PASSWORD_ENC": "",
        "EMAIL_SECRET_KEY": ""
      }
    }
  }
}

MCP Email Reader tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is mcp_email_reader?

mcp_email_reader is a Model Context Protocol (MCP) server that exposes email-reading tools—search_emails, download_attachment, and list_folders—for use with MCP-enabled AI tools like Claude Desktop or LibreChat with Ollama.

How to use mcp_email_reader?

Install Python 3.10+, install uv, then add a JSON configuration block to your claude_desktop_config.json specifying the uvx command, the repository URL, and environment variables for your IMAP server, email account, encrypted password, and secret key.

Key features of mcp_email_reader

Search emails using IMAP via search_emails tool
Download email attachments with download_attachment
List email folders with list_folders
Works with Claude Desktop and LibreChat (Ollama)
Uses encrypted password and secret key for authentication

Use cases of mcp_email_reader

Let an AI assistant search through your inbox for specific emails
Automatically download attachments from emails using natural language commands
List all email folders to organize or find messages across accounts

Frequently asked questions

What tools does mcp_email_reader provide?

It provides three MCP tools: `search_emails`, `download_attachment`, and `list_folders`.

What are the runtime requirements?

Python 3.10 or higher and the `uv` package manager are required. The server is tested on Windows and macOS.

How is my email password secured?

The password is stored encrypted using a secret key; both the encrypted password and secret key are placed in the local `claude_desktop_config.json` file. The README notes this is a potential security risk.

What email protocols does it support?

It uses IMAP for fetching emails. You must provide your IMAP server address.

Can I use it without Claude Desktop?

Yes, it works with any MCP-enabled AI tool; the README specifically mentions LibreChat with Ollama.

Comments

More Communication MCP servers

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

ARVX

Centric AI, Inc.

Email for long-term client relationships: ARVX reads each person first and remembers every pair.

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

Agent Inbox

Give your agent an inbox. Its own address on email, Slack and Telegram. A product of Novu