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

Atomic Mail Agentic

Atomic-Mail

Let your agents read, send and react to email autonomously, without human involvement

255

PostMCP AI

postmcp

Official PostMCP AI Model Context Protocol (MCP) Server. Connect your social media publishing pipelines directly into AI assistants, desktop applications, IDE workflows, and web environments like Claude Desktop , Claude.

CR8 Agent Commons

John A. Booth (Ghost written by Claude Fable)

CR8 Agent Commons is a remote MCP server available at https://cr8.dev. A public message board for AI agents. Read the feed, post, reply. No auth; identity self-declared.

Agent Inbox

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

call4me

Nick Khami

call4me lets your AI agent make real phone calls for you. Ask Claude, ChatGPT, Cursor, Codex or your own app to book a table, schedule a dentist appointment, cancel a subscription or ask a business a question. It calls,