mxHERO

This MCP server enables you to access mxHERO's multi-account email search service through a standard MCP interface. It lets you query stored emails across multiple accounts and retrieve results efficiently, supporting secure integration with client tools and AI solutions.

How to use

You can connect to this MCP server either by running a local stdio client that launches the mxmcp binary or by using the HTTP MCP endpoints. The HTTP endpoints provide a streamable connect option and a legacy SSE path for compatibility. The stdio option lets you run the MCP locally and expose it to your client tooling via a token.

How to install

Prerequisites: you need Go 1.22 or higher installed on your system.

Build and install steps (choose the command that matches your OS and architecture):

# Example build for macOS on ARM (adjust for your platform)
make mac-arm

# Example build for macOS on Intel
make mac-intel

# Example build for Linux on Intel
make linux-intel

After building, the binary will be placed in the bin directory. Copy the binary to a location you can access, for example:

cp bin/mxmcp-mac-arm ~user

Note: Some platforms may require additional permissions before running the program on another machine.

## Configuring for Claude Desktop (example MCP client setup)

If you are configuring Claude Desktop to use this MCP server, you can define an MCP server entry that points to the local mxmcp binary. The token you provide is required for authentication.

{ "mcpServers": { "mxhero-mcp-server": { "command": "<full path to mxmcp>", "args": [ "-t", "<token>", "-d", "<optional custom tool description>" ] } } }

## Available tools

### email\_search

Search stored emails using a query string and receive JSON results with matching emails and metadata.