AIMX: MCP tool for Hermes Agent

Self-hosted SMTP and stdio MCP server that gives AI agents their own email addresses

What AIMX does

AIMX, short for AI Mail Exchange, is a self-hosted SMTP server and stdio MCP server that gives AI agents their own email addresses. It ships as a single Rust binary with a guided setup that runs preflight checks on port 25, configures the domain and DNS, sets up a STARTTLS certificate and a trust policy, installs the service, and wires MCP for your agents.

Mail is stored as Markdown with TOML frontmatter, which suits LLM processing. Inbound mail fires on_receive hooks as soon as SMTP DATA completes, and outbound delivery fires after_send hooks, so no polling is needed. Delivery is direct server to server, and a DKIM-based trust model is meant to minimize prompt injection from incoming mail. The MCP server starts on demand and exits when done. The README names Hermes alongside OpenClaw, NanoClaw and Claude Code as agents it integrates with.

Key features

Self-hosted SMTP daemon with direct server-to-server delivery
Built-in stdio MCP server that runs only on demand
Markdown email with TOML frontmatter
on_receive and after_send hooks that fire immediately
DKIM-based trust model aimed at limiting prompt injection
Guided setup plus aimx doctor, logs and portcheck commands

When to use it

Give a Hermes or Claude Code agent its own address for sending and receiving mail
Trigger an agent action the moment a message arrives using an on_receive hook
Keep agent email on your own VPS instead of a hosted mail service

Who it is for: Developers running agents on a Linux server who want self-hosted email for those agents.

How it fits with Hermes Agent

AIMX is a general tool that integrates with several agents, and its README lists Hermes among them. The topics also include hermes-agent.

How to install AIMX

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

curl -fsSL https://aimx.email/install.sh | sh

Requirements: A Linux server with port 25 open inbound and outbound, and a domain or subdomain you control

FAQ

What is AIMX?

AIMX (AI Mail Exchange) is a self-hosted email server and stdio MCP server written in Rust. It gives AI agents their own email addresses and keeps the mail on your own machine.

Does AIMX work with Hermes Agent?

The README lists Hermes among the agents AIMX integrates with, alongside OpenClaw, NanoClaw and Claude Code. Because it is a standard MCP stdio server, any MCP-compatible client can also be wired up manually.

What do I need to run AIMX?

You need a Linux server with port 25 open in both directions and a domain or subdomain you control. The guided setup checks port 25, DNS and the STARTTLS certificate for you.