mxHERO MCP

How to Install and Use mxHERO MCP

If you want to use the mxHERO MCP (Model Context Protocol) server for advanced email search across multiple accounts, this simple guide will walk you through the installation and basic usage. Just follow the step-by-step instructions below.

Step 1: Clone the mxHERO MCP Repository

First, you need to get the mxHERO MCP code onto your computer. This is done by using the Git tool to clone the repository from GitHub. Open your terminal or command prompt and type:

git clone https://github.com/mxaiorg/mxmcp-py

This command downloads all the files needed for the mxHERO MCP.

Step 2: Install the ‘uv’ Tool

Before running the MCP server, you must install a tool named uv. This tool will help you create a virtual environment and manage your project easily.

• On MacOS or Linux, run this command:

curl -LsSf https://astral.sh/uv/install.sh | sh

• On Windows, use this command in PowerShell:

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

This installs uv so you’re ready for the next step.

Step 3: Set Up the Project Environment

Now, let’s prepare your project with a virtual environment. This helps keep your Python setup clean and organized. Follow these commands depending on your system:

• On MacOS or Linux:

uv venv
source .venv/bin/activate
uv lock

• On Windows:

uv venv
.venv\Scripts\activate
uv lock

This creates and activates the virtual space where you run the MCP server.

Step 4: Run the MCP Server

To start the mxHERO MCP server, you need to run a Python script from the project directory. Use the following command, replacing my_token with your actual access token:

uv --directory /fullpath/PycharmProjects/mxmcp-py run src/mxmcp.py --token "my_token"

Usually, your client software starts the MCP server automatically, but running it yourself makes sure it works correctly.

Step 5: Configure the Client (Example with Claude)

If you want to use Claude as your client to connect to mxHERO MCP, you need to set it up properly.

1. Open or create the config file claude_desktop_config.json located in your Claude app folder.
2. Add the following configuration, making sure to replace the directory path and token:

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

This setup tells Claude how to start the mxHERO MCP server for email searching.

---

Following these simple steps, you'll have mxHERO MCP installed, running, and connected to your client. This powerful tool lets you securely search and access large email repositories fast and easily.