About Nextmail
Nextmail connects AI agents to a Nextmail mailbox for businesses, developers and agent builders. It combines a remote MCP server with skills for email workflows, disposable inbox testing and migration from Resend.
Key features
- 01Send email through SDKs, API or CLI
- 02Work with a mailbox over MCP
- 03Use disposable inboxes for signup tests
- 04Move from Resend
Use cases
- 01Send email from application code
- 02Process messages in a mailbox
- 03Test signup flows using verification email
- 04Migrate an email setup from Resend
MCP support
The remote Nextmail MCP server at `https://api.nextmail.sh/mcp` provides mailbox access to clients after OAuth sign-in. Consent settings control the permissions and addresses available to the agent.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.nextmail.sh/mcpclaude mcp add --transport http sh-nextmail https://api.nextmail.sh/mcp{"mcpServers":{"sh-nextmail":{"type":"http","url":"https://api.nextmail.sh/mcp"}}}Open in Cursor{"servers":{"sh-nextmail":{"type":"http","url":"https://api.nextmail.sh/mcp"}}}Open in VS Code{"mcpServers":{"sh-nextmail":{"type":"http","url":"https://api.nextmail.sh/mcp"}}}{"mcpServers":{"sh-nextmail":{"serverUrl":"https://api.nextmail.sh/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMENextmail 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
- Privacy policy: https://nextmail.sh/privacy
- Terms: https://nextmail.sh/terms
- Support: [email protected]
- Documentation: https://nextmail.sh/docs/mcp/overview.md
License
MIT. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.