mxHero

You have a Python-based MCP server that connects mxHERO Mail2Cloud Advanced multi-account email search to your tooling. It lets you search stored emails across multiple accounts and access them through a standardized MCP interface, making it easier to build AI-powered email search capabilities at scale.

How to use

You can connect to this MCP server either through a remote HTTP endpoint or by running the server locally as a stdio process. The HTTP option provides a remote MCP URL you can call directly, while the stdio option runs the server on your machine and exposes commands locally via the MCP protocol.

How to install

Prerequisites: you need Python 3.13 or higher and the uv helper to run the MCP server. Follow these steps to set up and lock dependencies, then run the server.

# 1) Clone the project
git clone https://github.com/mxaiorg/mxmcp-py

# 2) Install uv if not installed yet
# MacOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 3) Create and set up the project
# MacOS/Linux
uv venv
source .venv/bin/activate
# Lock the dependencies
uv lock

# Windows
uv venv
.iref Scriptsactivate
# Lock the dependencies
uv lock

Running the MCP Server

You can start the MCP server in two ways. The HTTP URL is the remote connection, or you can run a local stdio instance with uv and point it to the server script with your token.

# 1) Run a local stdio server for testing
uv --directory /fullpath/PycharmProjects/mxmcp-py run src/mxmcp.py --token "my_token"

Using Claude as the client

If you want to use Claude as a client, specify the MCP server directory and token in Claude’s configuration so it can launch the local uv process and connect to the MCP endpoint.

{
  "mcpServers": {
    "mxhero-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/your_user/Desktop/mxmcp-py",
        "run",
        "src/mxmcp.py",
        "--token",
        "<copy_your_token_here>"
      ]
    }
  }
}

Available tools

email_search

Search stored emails by a query and return matching results from the mxHERO Mail2Cloud Advanced tenant.