mcp_email_reader

Model Context Protocol (MCP) server exposes several mcp tools called search_emails, download_attachment and list_folders. This has been tested on Claude Desktop and LibreChat with Ollama.

Installation

Prerequisites

Windows

1. Install Claude Desktop (or another MCP-enabled AI tool)

2. Install Python 3.10 or higher:

3. Install uv:

macOS

1. Install Claude Desktop (or another MCP-enabled AI tool)

2. Install Python 3.10 or higher:

3. Install uv:

Configuration

Add the following to your `claude_desktop_config.json`:

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

Note: Clearly, the secret key can be used to decrypt the encrypted password and is therefore a potential security risk - although claude_desktop_config.json is stored locally on your laptop/PC. It has been added to the json file above since it is not possible to add a .env file when using uvx to clone the repo dynamically.

Attribution

This software package implements the ability to read emails into a MCP enabled framework and is developed by karateboss.

Contributing

We welcome contributions to improve these tools. Please submit issues and pull requests through our repository.

Support

For questions and support:

1. Check our documentation

2. Submit an issue in our repository