Log inSubmit server
Agenticmail logo

Agenticmail

by agenticmail

Runs a local mail server for agents to send and receive email, use disposable inboxes, retrieve codes, and send SMS.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Agenticmail

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "agenticmail-agenticmail": {
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/cli@latest"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y @agenticmail/cli@latest

npm notice npm notice New major version of npm available! 10.1.0 -> 12.0.2 npm notice Changelog: <https://github.com/npm/cli/releases/tag/v12.0.2> npm notice Run `npm install -g npm@12.0.2` to update! npm notice npm ERR! could not determine executable to run npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-09-18T11_11_23_428Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The agenticmail/agenticmail MCP server gives AI agents real email addresses and phone numbers through a locally run service. It supports sending and receiving email, disposable inboxes, verification-code retrieval, SMS, and interaction with a real inbox without relying on a third-party email API. Install the MCP package with npx, or use the repository’s CLI bootstrap flow for Claude Code. Reach for it when an agent must complete workflows that depend on email or phone-based communication.

Use cases

  • Create disposable inboxes for agent-run registrations
  • Send and monitor email during automated workflows
  • Retrieve verification codes from incoming messages
  • Send SMS or manage phone-based agent tasks

Key features

  • Local mail server
  • Disposable inboxes
  • Real email send and receive
  • Verification-code retrieval
  • SMS and phone workflows

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

21/21 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @agenticmail/cli@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars242Stargazers on the source repository.
npm downloads2.7kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Agenticmail works

What agenticmail/agenticmail MCP server does

The agenticmail/agenticmail MCP server connects AI agents to real email and SMS workflows. It can provide disposable inboxes, send messages, receive messages, retrieve verification codes, and operate an inbox programmatically. The project is designed to run locally rather than route core email activity through a third-party email API.

This makes it suitable for agents that need to register for services, monitor an inbox, respond to incoming mail, or complete processes that deliver one-time codes by email or SMS. The repository also describes phone-based capabilities, including outbound calling and realtime voice support through supported carrier transports, but those features require additional configuration and services.

How it works

The MCP package exposes AgenticMail functionality to an MCP-compatible client. The local service manages the agent’s mail and messaging operations, while disposable inboxes provide temporary addresses for workflows where a permanent mailbox is unnecessary. Agents can use received messages and verification codes as inputs to subsequent tasks.

The broader project includes an HTTP API and agent-oriented features beyond basic messaging. Its later releases describe persistent per-agent memory, Telegram messaging, phone missions, and voice bridges. These capabilities are part of the same project but may depend on separate providers, credentials, or configuration. The media toolset described in the repository is marked unreleased and should not be treated as a generally available MCP capability.

Setup and configuration

The simplest MCP installation described by the project is:

Terminal
npx -y @agenticmail/mcp

The repository’s setup instructions also provide a CLI-based route for Claude Code: install @agenticmail/cli globally and run agenticmail bootstrap. That flow is presented as an alternative setup path and asks the user to restart Claude Code afterward.

Phone features also require a provisioned number with a supported transport provider, including 46elks or Twilio, depending on the feature and setup.

Tools and capabilities

The agenticmail/agenticmail MCP server supports:

  • Sending real email from an agent.
  • Receiving email and working with an inbox.
  • Creating or using disposable inboxes.
  • Fetching verification codes from received messages.
  • Sending and receiving SMS through the project’s phone functionality.
  • Connecting agents to phone-call workflows, including realtime voice features described in the repository.

The project also documents MCP memory tools and a Telegram channel in newer releases. Those are additional agent features rather than replacements for the email and SMS functions.

Limitations and notes

Some capabilities are provider-dependent. The README identifies 46elks and Twilio as phone transport options, and realtime voice additionally depends on OpenAI Realtime configuration. The live voice paths described for those releases still require operator smoke testing according to the repository notes.

The media/video tools are explicitly labeled unreleased. They also depend on locally installed binaries such as ffmpeg, ffprobe, ImageMagick, whisper.cpp, or Python, none of which are bundled. Avoid assuming that these tools are available in the published MCP installation.

Those details should be verified in the repository before production deployment.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Agenticmail

Run `npx -y @agenticmail/mcp`. The repository also documents a CLI bootstrap flow for Claude Code using `@agenticmail/cli`.

Yes. The project description specifically supports disposable inboxes and fetching verification codes from received email.

No third-party email API is required for its local mail-server workflow, according to the project description.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAgenticmail AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/agenticmail-agenticmail?style=directory)](https://allmcps.com/mcp/agenticmail-agenticmail)
HTML Embed
<a href="https://allmcps.com/mcp/agenticmail-agenticmail"><img src="https://allmcps.com/api/badge/agenticmail-agenticmail?style=directory" alt="Agenticmail on AllMCPs" /></a>