MCP Enabled Email Reader
About
MCP server to connect to an email server and search emails
Details
- License
- Apache-2.0 license
Explore
- Search emails via the search_emails tool
- Download attachments using download_attachment
- List email folders with list_folders
- Works with any IMAP email server
- Supports encrypted password storage
- Tested on Claude Desktop and LibreChat
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Enabled Email ReaderCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp enabled email reader": {
"mcp-pdf-reader": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Safe-Swiss-Cloud-AG/mcp_email@main",
"mcp_email"
],
"env": {
"IMAP_SERVER": "",
"EMAIL_ACCOUNT": "",
"EMAIL_PASSWORD_ENC": "",
"EMAIL_SECRET_KEY": ""
}
}
}
}
}
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_ACCOUNT": "",
"EMAIL_PASSWORD_ENC": "",
"EMAIL_SECRET_KEY": ""
}
}
}
Installation
Prerequisites
Windows
1. Install Claude Desktop (or another MCP-enabled AI tool) - Download Claude for Desktop - Follow the current installation instructions: Installing Claude Desktop 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 withpython --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) - Download Claude for Desktop - Follow the current installation instructions: Installing Claude Desktop 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



