Give your agent an email address. Then get out of its way.

# Create a mailbox (operations token)
curl -X POST https://trekmail.net/api/v1/mailboxes \
  -H "Authorization: Bearer tm_live_…" \
  -H "Idempotency-Key: support-acme-2026" \
  -H "Content-Type: application/json" \
  -d '{ "domain_id": 1, "local_part": "support" }'

# Read unread messages (message token)
curl https://trekmail.net/api/v1/messages?unread_only=true \
  -H "Authorization: Bearer tm_msg_…"

import os, requests

base = "https://trekmail.net/api/v1"
ops  = {"Authorization": f"Bearer {os.environ['TM_OPS']}"}
msg  = {"Authorization": f"Bearer {os.environ['TM_MSG']}"}

# Provision a mailbox
requests.post(f"{base}/mailboxes", headers=ops,
              json={"domain_id": 1, "local_part": "support"})

# Pull the inbox
unread = requests.get(f"{base}/messages", headers=msg,
                      params={"unread_only": True}).json()

// Node 20+ — native fetch, no SDK required
const headers = {
  "Authorization": `Bearer ${process.env.TM_OPS}`,
  "Idempotency-Key": "support-acme-2026",
  "Content-Type": "application/json"
}

const mbox = await fetch("https://trekmail.net/api/v1/mailboxes", {
  method: "POST", headers,
  body: JSON.stringify({ domain_id: 1, local_part: "support" })
}).then(r => r.json())

# 1. clone & build the open-source MCP server
git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp && npm install && npm run build

# 2. add to claude_desktop_config.json
{
  "mcpServers": {
    "trekmail": {
      "command": "node",
      "args": ["./trekmail-mcp/build/index.js"],
      "env": {
        "TREKMAIL_BASE_URL": "https://trekmail.net",
        "TREKMAIL_API_TOKEN": "tm_live_…",
        "TREKMAIL_MESSAGE_TOKEN": "tm_msg_…",
        "TREKMAIL_ALLOW_SENDING": "false",
        "TREKMAIL_ALLOW_DESTRUCTIVE": "false"
      }
    }
  }
}