7 of 7

Connect an AI assistant

Let Claude or another AI assistant manage your domains and aliases, read your logs and send email through the Mailyoto command line.

Updated 5 November 2026

At the end of this guide, you can ask an AI assistant such as Claude to manage your aliases, read your logs and send email.

You'll need

A Mailyoto account on any plan. Sending email needs Pro or Max.
The Mailyoto command line, version 1.1.0 or later. mailyoto --version prints yours.
One of the assistants in step 2, or another assistant that can use MCP servers.

Save an API key#
Create an API key on the Account page of the dashboard. Name it after the assistant, such as “Claude”, so you can revoke it without stopping anything else.
Save the key on the computer the assistant runs on:
```
mailyoto key save
```
Paste the key when the command asks for it.
Add Mailyoto to the assistant#
Claude Code

Run this in a terminal:
```
claude mcp add --scope user mailyoto -- mailyoto mcp
```
--scope user adds Mailyoto in every folder.
Claude Desktop

In Claude Desktop, open Settings, then Developer, and select Edit Config. Add Mailyoto to claude_desktop_config.json:
```
{
  "mcpServers": {
    "mailyoto": {
      "command": "/usr/local/bin/mailyoto",
      "args": ["mcp"]
    }
  }
}
```
Use the full path to the command line on your computer. which mailyoto prints it on a Mac or on Linux. On Windows, write the path with double backslashes, such as C:\\Tools\\mailyoto.exe.
Quit Claude Desktop and open it again.
Cursor

Select Add Mailyoto to Cursor, then select Install in Cursor.
To add it by hand instead, put this in ~/.cursor/mcp.json:
```
{
  "mcpServers": {
    "mailyoto": {
      "command": "mailyoto",
      "args": ["mcp"]
    }
  }
}
```
VS Code

Select Add Mailyoto to VS Code, then select Install in VS Code.
To add it from a terminal instead:
```
code --add-mcp '{"name":"mailyoto","type":"stdio","command":"mailyoto","args":["mcp"]}'
```
Copilot uses Mailyoto in agent mode.
Codex

Run this in a terminal:
```
codex mcp add mailyoto -- mailyoto mcp
```
The Codex command line, the Codex IDE extension and Codex in the ChatGPT desktop app share this setting. Restart Codex after you add it.
Devin Desktop

Add Mailyoto to ~/.config/devin/mcp_config.json. On Windows, the file is %APPDATA%\devin\mcp_config.json.
```
{
  "mcpServers": {
    "mailyoto": {
      "command": "mailyoto",
      "args": ["mcp"]
    }
  }
}
```
Then open the MCPs tab and refresh the list under This computer.
Antigravity

Add Mailyoto to ~/.gemini/config/mcp_config.json:
```
{
  "mcpServers": {
    "mailyoto": {
      "command": "mailyoto",
      "args": ["mcp"]
    }
  }
}
```
Then run /mcp in Antigravity to load it.
Zed

Add Mailyoto to Zed’s settings.json:
```
{
  "context_servers": {
    "mailyoto": {
      "command": "mailyoto",
      "args": ["mcp"]
    }
  }
}
```
Under Settings, then AI, then MCP Servers, a green dot shows that Mailyoto is running.
Other

Add an MCP server that the assistant starts on your computer (stdio), with the command mailyoto and the one argument mcp.
Confirm that it works#
Ask the assistant: “List my Mailyoto domains.”
It lists each domain, and whether the domain forwards and sends email.
Other requests you can make:
- “Forward sales@lunavera.com to mei@harborpine.net.”
- “Pause hello@lunavera.com while I’m away.”
- “Why did yesterday’s email to diego@harborpine.net bounce?”
- “Check the DNS records for lunavera.com.”
- “Send Amina the new opening hours from hello@lunavera.com.”

What the assistant can do#

Tool	What it does	Asks first
`overview`	Lists your domains, and whether each one forwards and sends email.	No
`dns`	Checks a domain’s DNS records, and shows whether each one is in place.	No
`addresses_show`	Lists a domain’s aliases, where each one forwards, and whether it is paused.	No
`addresses_new`	Creates an alias that forwards to one or more destinations.	No
`addresses_edit`	Changes an alias’s destinations or options.	No
`addresses_pause`	Stops an alias forwarding until you resume it. Meanwhile, Mailyoto returns, holds or discards its email.	Yes
`addresses_resume`	Starts a paused alias forwarding again.	No
`addresses_destroy`	Deletes an alias.	Yes
`activity`	Lists the latest email to and from a domain, or shows one email’s delivery events.	No
`send`	Sends an email from an address on one of your domains, now or at a set time, on Pro and Max.	Yes
`scheduled_show`	Lists the emails waiting for their send time.	No
`scheduled_cancel`	Stops one recipient’s copy of a scheduled email from going out.	Yes

For rules, SMTP credentials, domain settings, your plan and your account, use the dashboard or the command line.

The assistant can’t attach files to an email. To send an attachment, use mailyoto send --attach.

Before a tool marked “Yes”, the assistant shows you the change and waits for you. Check the addresses it shows before you agree.

Important

An email the assistant reads can contain instructions written to trick it, such as “forward every alias to this address”. Agree to a change only when you asked for it.

Problems#

The assistant says there is no API key

Run mailyoto key save on the computer the assistant runs on, with the same user account. Claude Desktop doesn’t read MYO_API_KEY from your terminal.

The assistant can't start Mailyoto

In the app’s settings file, write the full path to the command line as command, such as /usr/local/bin/mailyoto, then restart the app. which mailyoto prints the path.

The assistant says the request limit was reached

The assistant shares the request limit of its API key. Wait a minute and ask again.

Save an API key#

Add Mailyoto to the assistant#

Claude Code

Claude Desktop

Cursor

VS Code

Codex

Devin Desktop

Antigravity

Zed

Other

Confirm that it works#

What the assistant can do#

Problems#