Self-hosted email for AI agents with mailboxes on your own domain, task threads, approvals and webhooks, available over MCP and REST.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add openagentemail --env OPENAGENTEMAIL_API_KEY='<OPENAGENTEMAIL_API_KEY>' -- npx -y @openagentemail/mcp~/.codex/config.toml
[mcp_servers.openagentemail]
command = "npx"
args = ["-y", "@openagentemail/mcp"]
env = { OPENAGENTEMAIL_API_KEY = "<OPENAGENTEMAIL_API_KEY>" }
# codex mcp add openagentemail --env OPENAGENTEMAIL_API_KEY='<OPENAGENTEMAIL_API_KEY>' -- npx -y @openagentemail/mcp~/.cursor/mcp.json
{
"mcpServers": {
"openagentemail": {
"command": "npx",
"args": [
"-y",
"@openagentemail/mcp"
],
"env": {
"OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"openagentemail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@openagentemail/mcp"
],
"env": {
"OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"openagentemail": {
"command": "npx",
"args": [
"-y",
"@openagentemail/mcp"
],
"env": {
"OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"openagentemail": {
"command": "npx",
"args": [
"-y",
"@openagentemail/mcp"
],
"env": {
"OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"openagentemail": {
"command": "npx",
"args": [
"-y",
"@openagentemail/mcp"
],
"env": {
"OPENAGENTEMAIL_API_KEY": "<OPENAGENTEMAIL_API_KEY>"
}
}
}
}Environment variables
OPENAGENTEMAIL_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.