MCP Server for mxHERO Multi-Account Email Search
Description
This MCP (model context protocol) server is a Python project that provides access to mxHERO's Mail2Cloud Advanced multi-account email search service.
The Model Context Protocol (MCP) is a framework designed to standardize the way models interact with various data sources and services. In this project, MCP is used to facilitate seamless integration to mxHERO Mail2Cloud Advanced. Mail2Cloud Advanced is a high performance data service for a company's email data. Mail2Cloud Advanced connects to company email services and optimizes the content for fast, scalable and secure access by AI solutions.
Architecture
Mail2Cloud is designed to selectively capture emails from one or more accounts. The selection of emails can be finely controlled by powerful filters examining any aspect of messages and their attachments. Captured emails are then optimized and stored into an isolated tenant in a vector database designed for email related searches. This MCP accesses the stored emails in the tenant through authenticated access credentials.
Advantages
Solutions built with Mail2Cloud Advanced MCP outperforms other AI solutions with regards to email data search & knowledge recovery (study)
- Provides secure links to original emails (safe from accidental user deletion, etc.)
- Allows LLMs to search massive email repositories, far beyond their context window restraints.
Demo Accounts
To facilitate exploration of this MCP, mxHERO provides demo accounts that are pre-loaded with thousands of emails. More about the demo emails can be found here.
See 'Access Tokens' below to get a token.
For more information see: mxHERO Mail2Cloud Advanced multi-email account service, including architecture, and optimizations.
Alternate versions
A Go version (plus prebuilt binaries) can be found here.
Streamable HTTP
This MCP repo is the 'stdio' variant. HTTP options exist at the following addresses:
- https://lab4-api.mxhero.com/mcp/connect (streamable HTTP)
- https://lab4-api.mxhero.com/mcp/sse (Legacy SSE)
Tools implemented
email_search
Search stored emails
Parameters
query(str): Email search query
Returns JSON of search results
Requirements
- Python 3.13 or higher
- mxHERO Vector Search token
Access Tokens
- A demo token can be obtained at https://lab4-api.mxhero.com/demo_signup
- For production tokens, uncheck "Demo" and Request an account (or contact mxHERO at contact@mxhero.com).
Installation
- Clone the repository
git clone https://github.com/mxaiorg/mxmcp-py
-
Install
uvif not installed yet:2.1 MacOS+Linux
curl -LsSf https://astral.sh/uv/install.sh | sh2.2 Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -
Create and set up our project:
3.1 MacOS+Linux
# Create virtual environment and activate it uv venv source .venv/bin/activate # Lock the dependencies uv lock3.2 Windows
# Create virtual environment and activate it uv venv .venv\Scripts\activate # Lock the dependencies uv lock
Usage
Running the MCP Server
To start the MCP server, run the following command:
uv --directory /fullpath/PycharmProjects/mxmcp-py run src/mxmcp.py --token "my_token"
Typically you don't need to start the server, your client will do it, but it is useful to make sure things are working.
Using Claude as the client
-
Edit your
claude_desktop_config.json:code ~/Library/Application\ Support/Claude/claude_desktop_config.json...or use your favorite json editor.
- You may need to create the file if it does not already exist.
-
Add the configuration:
-
Replace the --directory argument value ('/Users/...') with the absolute (full) path to the python script.
{ "mcpServers": { "mxhero-mcp-server": { "command": "uv", "args": [ "--directory", "/Users/your_user/Desktop/mxmcp-py", "run", "src/mxmcp.py", "--token", "<copy_your_token_here>" ] } } }
MCP library
https://gofastmcp.com/servers/tools
Notice
Using this client against the hosted service requires an account/API key and is governed by our ToS.