MCP Enabled Email Reader

MCP Enabled Email Reader

By Safe-Swiss-Cloud-AG GitHub

MCP server to connect to an email server and search emails

mcp_email email-reader
Overview

What is MCP Enabled Email Reader?

MCP Enabled Email Reader is a tool that connects to an email server and allows users to search emails, download attachments, and list folders using the Model Context Protocol (MCP).

How to use MCP Enabled Email Reader?

To use the MCP Enabled Email Reader, install Claude Desktop or another MCP-enabled AI tool, set up Python, and configure the necessary settings in the claude_desktop_config.json file with your email server details.

Key features of MCP Enabled Email Reader?

  • Connects to email servers using MCP.
  • Allows searching of emails, downloading attachments, and listing folders.
  • Compatible with Claude Desktop and other MCP-enabled tools.

Use cases of MCP Enabled Email Reader?

  1. Automating email retrieval and processing for applications.
  2. Integrating email functionalities into AI-driven tools.
  3. Enhancing productivity by managing emails through MCP.

FAQ from MCP Enabled Email Reader?

  • What is required to run MCP Enabled Email Reader?

You need Claude Desktop, Python 3.10 or higher, and the uv package installed.

  • Is there a risk with storing sensitive information in the configuration file?

Yes, the configuration file contains sensitive information like email passwords, so ensure it is stored securely.

  • Can I contribute to the MCP Enabled Email Reader project?

Yes, contributions are welcome through issues and pull requests on the GitHub repository.

Content

MCP Enabled 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:

    • Download the latest Python installer from python.org
    • Run the installer, checking "Add Python to PATH"
    • Open Command Prompt and verify installation with python --version

  3. Install uv:

    • Open Command Prompt as Administrator
    • Run pip install --user uv
    • Verify installation with uv --version

macOS

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

  2. Install Python 3.10 or higher:

    • Using Homebrew: brew install python
    • Verify installation with python3 --version

  3. Install uv:

    • Using Homebrew: brew install uv
    • Alternatively: pip3 install --user uv
    • Verify installation with uv --version

Configuration

Add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-pdf-reader": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/Safe-Swiss-Cloud-AG/mcp_email@main",
                "mcp_email"
            ],
        "env": {
            "IMAP_SERVER": "<email server>",
            "EMAIL_ACCOUNT": "<user email account>",
            "EMAIL_PASSWORD_ENC": "<encrypted password>"
            "EMAIL_SECRET_KEY": "<secret key used to encypt password>"
        }
    }
}

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 Safe Swiss Cloud.

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
No tools information available.
No content found.