Nextmail

AI-native email for businesses, developers, and AI agents.

GitHub
1

Hosted MCP Server

npx add-mcp 'https://api.nextmail.sh/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Nextmail for AI agents

Email for AI agents and for the people who build them, from Nextmail. This repository connects your agent to your own Nextmail mailbox, and teaches it the jobs people most often hand to an agent: sending email from code, working through an inbox, catching verification emails in tests, and moving from Resend.

What is in it

  • One MCP server, https://api.nextmail.sh/mcp, the remote server Nextmail runs. Your client signs in with OAuth in the browser, and on the consent page you choose which permissions and which addresses the agent may use. You can narrow or remove the connection later under Account, Connected apps.
  • Four skills, in skills/: sending email with the SDKs, the API or the CLI; working in a mailbox over MCP; disposable inboxes for sign-up tests; and moving from Resend.

Install

Claude Code

/plugin marketplace add nextmailhq/mcp
/plugin install nextmail@nextmail

Claude, ChatGPT and other chat apps. Add https://api.nextmail.sh/mcp as a custom connector.

Codex. Add this to ~/.codex/config.toml:

[mcp_servers.nextmail]
url = "https://api.nextmail.sh/mcp"

Gemini CLI

gemini extensions install https://github.com/nextmailhq/mcp

Any agent that reads skills

npx skills add nextmailhq/mcp

Cursor, VS Code, Windsurf and other MCP clients. See https://nextmail.sh/docs/mcp/connect.md

What it runs, sends and fetches

Nothing in this repository runs on your machine. The skills are written instructions, and the plugin adds one remote MCP server, which your client reaches over HTTPS at https://api.nextmail.sh/mcp once you have signed in. Its tools act on your Nextmail workspace, with the permissions you approved, and every tool is marked as reading or as making changes, so your client can ask before anything is sent or changed. The skills link to the documentation at https://nextmail.sh, and to the Nextmail SDK and CLI packages, which are installed only if you choose to.

Privacy, terms and support

License

MIT. See LICENSE.