MCP.so
Sign In

mcp_email_reader

@karateboss

Repository

About mcp_email_reader

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

Basic information

Category

Communication

License

Apache-2.0 license

Runtime

python

Transports

stdio

Publisher

karateboss

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": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

FAQ from mcp_email_reader

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

Teams Mcp

floriscornel

MCP server providing comprehensive Microsoft Teams and Graph API access for AI assistants including messaging, search, and user management.

120

Email sending MCP 💌

ykhli

The official MCP server to send emails and interact with Resend

549

MCP Communicator (Telegram)

qpd-v

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.

45

Telegram MCP Server

kfastov

Telegram user console client and archiver

40

WhatsApp MCP Server (TypeScript/Baileys)

jlucaso1

WhatsApp MCP Server (TypeScript/Baileys)

67