Set up and use Command Mail.

01Quick start

1. Access. We set up new accounts for selected participants in the personally guided pilot. Apply for the pilot. If you already have access, you can log in.
2. Connect addresses. Do it yourself or through your agent. Each address gets its own private inbound address. Here’s how.
3. Connect your agent. Add the MCP URL https://commandmail.app/mcp in Claude or ChatGPT, or use the Claude Code command. Instructions by client.
4. Approve permissions. On the authorization page, you choose what your agent can do. Scopes and Autonomy explain the levels.

02Forward your addresses

Command Mail is one inbox for multiple addresses and domains you own. Email arrives through forwarding, for example from Gmail or your own domain. Each address gets its own private inbound address.

Connect an address

Use the browser or CLI. Then set up forwarding with your existing provider to that address’s private inbound address.

commandmail mailboxes connect mara@beispiel.de

Your own domain

Verify ownership of your domain with a DNS TXT record: first claim it, then verify it.

commandmail domains claim studio-beispiel.de
# Add the TXT record at your DNS provider
commandmail domains verify studio-beispiel.de

Import existing emails

Import MBOX and EML exports or folders of EML files through the CLI. First connect the destination mailbox and log in to the CLI. For example:

commandmail import export.mbox --mailbox mara@beispiel.de --state archive

Import brings in existing messages. It does not set up continuous sync with your previous provider.

Let your agent set it up

If your agent has the scope mailboxes, it can handle these steps. For example, say: “Set up hallo@studio-beispiel.de in Command Mail.” It connects the address, claims the domain if needed, gives you the TXT record, verifies it and tells you where to forward email.

03Connect your agent

All agents use the same operations through hosted MCP with OAuth, local MCP, CLI or REST. Every session starts with capabilities. This shows the agent the owner, scopes, mailboxes with their autonomy levels and its limits.

claude mcp add --transport http \
  commandmail https://commandmail.app/mcp

More on permissions, workflow and limits: For agents.

04CLI

The CLI is called commandmail. It works with scripts and scheduled tasks.

Install with one line, then log in. Requires Node.js 18 or later.

curl -fsSL https://commandmail.app/install.sh | sh
commandmail login

Custom views and the agent guide

Use the + next to the inbox tabs to create a custom view, such as “Customer conversations”. The view uses a shared label and includes archived emails with that label. Creating a view does not move any email.

Your agent receives our guide to organizing and archiving with the CLI installation. Through MCP, it reads the guide with get_organization_guide, or through the CLI with commandmail skill. It also explains how to handle your exceptions, false positives, invoices and narrowly defined filters.

commandmail skill
commandmail labels create --name "Kundenkommunikation"
commandmail labels list --json
commandmail inbox --label LABEL_ID --json

A new view starts with manual assignments. Enable automatic labels in settings. Your agent suggests spam and archive rules based on concrete examples; you enable them under “Automation & rules”. Marking something as spam alone does not activate a rule.

In the morning brief, reported payment issues appear under “Review payments”, linked to the original email. A payment confirmation is not treated as an outstanding balance. Check the current balance with the provider; an email or risk score alone does not prove it.

05Scopes

Scopes define what a key or connected session can do. Grant only what the agent needs.

06Autonomy

Set the autonomy level for each mailbox: read → suggest → rules → auto.

Activity log

Actions taken by agents and rules appear in the activity log and can be undone. Suggestions wait there for your decision.

07Let your agent reply

For mailboxes such as customer support, a suitably configured agent can answer questions and send replies independently. It knows your offers, agreements and tone only from the information and sources you make available to it. Regular execution is configured separately in the agent.

1. Grant permission. On the authorization page, grant this agent mail:send. Agents that only sort email do not need it.
2. Set a daily limit. In settings under Automation; the default is 50 emails per day.
3. Read the log. Every sent email appears in the activity log.

08Morning brief

The morning brief summarizes what arrived since yesterday and what is due by tomorrow:

• Decisions waiting for you
• Deadlines
• Pending replies
• Follow-ups that are due
• What arrived since yesterday

Expand it to the week with one button. Agents retrieve it with morning_brief.

09Risk assessment

Each email receives percentage estimates for spam, fraud and phishing. The assessment reads text only. It never opens links or attachments.

Categories and markers

Alongside risk assessment, Command Mail sorts email into General, Social, Promotions, Updates and Forums, and adds markers such as Appointment, Invoice, Deadline and Security.

10Frequently asked questions