Mails.ai — Agent Email MCP server

Q: How do I add Mails.ai — Agent Email MCP to Claude Code?

Run `claude mcp add --env 'MAILS_API_KEY= ' agent-email -- npx -y @mailsai/mcp-server` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Mails.ai — Agent Email MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

ai.mails/agent-email

A real inbox for AI agents: send, receive and thread email, behind a prompt-injection firewall.

Also known as agent-email, @mailsai/mcp-server

stdio remote

Install

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.5.0
Last commit: —
License: —

What is Mails.ai — Agent Email MCP?

Mails.ai — Agent Email is a real inbox for AI agents: send, receive and thread email, behind a prompt-injection firewall.

How to install Mails.ai — Agent Email MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --env 'MAILS_API_KEY=<YOUR_MAILS_API_KEY>' agent-email -- npx -y @mailsai/mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-email": {
      "command": "npx",
      "args": [
        "-y",
        "@mailsai/mcp-server"
      ],
      "env": {
        "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "agent-email": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mailsai/mcp-server"
      ],
      "env": {
        "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>"
      }
    }
  }
}

$ code --add-mcp '{"name":"agent-email","type":"stdio","command":"npx","args":["-y","@mailsai/mcp-server"],"env":{"MAILS_API_KEY":"<YOUR_MAILS_API_KEY>"}}'

claude_desktop_config.json

{
  "mcpServers": {
    "agent-email": {
      "command": "npx",
      "args": [
        "-y",
        "@mailsai/mcp-server"
      ],
      "env": {
        "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>"
      }
    }
  }
}

$ codex mcp add agent-email --env 'MAILS_API_KEY=<YOUR_MAILS_API_KEY>' -- npx -y @mailsai/mcp-server

~/.codex/config.toml

[mcp_servers.agent-email]
command = "npx"
args = ["-y", "@mailsai/mcp-server"]

[mcp_servers.agent-email.env]
MAILS_API_KEY = "<YOUR_MAILS_API_KEY>"

$ gemini mcp add -s user -e 'MAILS_API_KEY=<YOUR_MAILS_API_KEY>' agent-email npx -- -y @mailsai/mcp-server

~/.gemini/settings.json

{
  "mcpServers": {
    "agent-email": {
      "command": "npx",
      "args": [
        "-y",
        "@mailsai/mcp-server"
      ],
      "env": {
        "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>"
      }
    }
  }
}

Set 2 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

MAILS_API_KEYRequiredSecret
Your mails.ai API key. Use an mk_test_ key to run against the sandbox or an mk_live_ key to send real mail. Free key at https://mails.ai
MAILS_BASE_URL
Override the API base URL. Defaults to the hosted mails.ai API; only needed for staging or self-hosted deployments.

Name	Description
MAILS_API_KEY	Your mails.ai API key. Use an mk_test_ key to run against the sandbox or an mk_live_ key to send real mail. Free key at https://mails.ai	RequiredSecret
MAILS_BASE_URL	Override the API base URL. Defaults to the hosted mails.ai API; only needed for staging or self-hosted deployments.

Mails.ai — Agent Email MCP questions

How do I add Mails.ai — Agent Email MCP to Claude Code?

Run claude mcp add --env 'MAILS_API_KEY=<YOUR_MAILS_API_KEY>' agent-email -- npx -y @mailsai/mcp-server in your terminal. Add --scope user to make it available in every project.

How do I add Mails.ai — Agent Email MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Facts

Nov 11, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.5.0
Last commit: —
License: —
Transport: stdio, remote
Package: @mailsai/mcp-server

mails

Community publisher

Published by an independent maintainer.

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/mails/agent-email.svg)](https://hostedmcp.org/servers/mails/agent-email/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

{ "mcpServers": { "agent-email": { "command": "npx", "args": [ "-y", "@mailsai/mcp-server" ], "env": { "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>" } } } }

{ "servers": { "agent-email": { "type": "stdio", "command": "npx", "args": [ "-y", "@mailsai/mcp-server" ], "env": { "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>" } } } }

{ "mcpServers": { "agent-email": { "command": "npx", "args": [ "-y", "@mailsai/mcp-server" ], "env": { "MAILS_API_KEY": "<YOUR_MAILS_API_KEY>" } } } }

Configuration

MAILS_API_KEYRequiredSecret

Your mails.ai API key. Use an mk_test_ key to run against the sandbox or an mk_live_ key to send real mail. Free key at https://mails.ai

MAILS_BASE_URL

Override the API base URL. Defaults to the hosted mails.ai API; only needed for staging or self-hosted deployments.

Name	Description
MAILS_API_KEY	Your mails.ai API key. Use an mk_test_ key to run against the sandbox or an mk_live_ key to send real mail. Free key at https://mails.ai	RequiredSecret
MAILS_BASE_URL	Override the API base URL. Defaults to the hosted mails.ai API; only needed for staging or self-hosted deployments.

Mails.ai — Agent Email MCP questions

How do I add Mails.ai — Agent Email MCP to Claude Code?

Run claude mcp add --env 'MAILS_API_KEY=<YOUR_MAILS_API_KEY>' agent-email -- npx -y @mailsai/mcp-server in your terminal. Add --scope user to make it available in every project.

How do I add Mails.ai — Agent Email MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Mails.ai — Agent Email MCP server

What is Mails.ai — Agent Email MCP?

How to install Mails.ai — Agent Email MCP

Install Mails.ai — Agent Email MCP in Claude Code

Install Mails.ai — Agent Email MCP in Cursor

Install Mails.ai — Agent Email MCP in VS Code

Install Mails.ai — Agent Email MCP in VS Code CLI

Install Mails.ai — Agent Email MCP in Claude Desktop

Install Mails.ai — Agent Email MCP in Codex

Install Mails.ai — Agent Email MCP in Codex config.toml

Install Mails.ai — Agent Email MCP in Gemini CLI

Install Mails.ai — Agent Email MCP in Gemini settings.json

Configuration

Mails.ai — Agent Email MCP questions

Mails.ai — Agent Email MCP server

What is Mails.ai — Agent Email MCP?

How to install Mails.ai — Agent Email MCP

Install Mails.ai — Agent Email MCP in Claude Code

Install Mails.ai — Agent Email MCP in Cursor

Install Mails.ai — Agent Email MCP in VS Code

Install Mails.ai — Agent Email MCP in VS Code CLI

Install Mails.ai — Agent Email MCP in Claude Desktop

Install Mails.ai — Agent Email MCP in Codex

Install Mails.ai — Agent Email MCP in Codex config.toml

Install Mails.ai — Agent Email MCP in Gemini CLI

Install Mails.ai — Agent Email MCP in Gemini settings.json

Configuration

Mails.ai — Agent Email MCP questions