# AgenticMail — Email + SMS Infra for AI Agents (MCP)

> AgenticMail provides email + SMS infrastructure for AI agents, with a CLI setup wizard plus an MCP server so tools can send/receive messages under control.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
npm install -g @agenticmail/cli@latest
agenticmail setup --yes
agenticmail start
agenticmail status
# optional MCP-only install:
npm install -g @agenticmail/mcp@latest
```

## Intro

AgenticMail provides email + SMS infrastructure for AI agents, with a CLI setup wizard plus an MCP server so tools can send/receive messages under control.

**Best for:** agents that need real inbox/outbox workflows with approvals

**Works with:** Node.js, Docker (mail server), MCP clients, Claude Code/Cursor-style tool runners

**Setup time:** 10-25 minutes

### Key facts (verified)

- GitHub: 118 stars · 21 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `npm install -g @agenticmail/cli`.

## Main

- Use `agenticmail setup --yes` for a non-interactive, safe-default install path when you’re automating setup via scripts or agents.

- Treat `agenticmail start` + the interactive shell as your ops console: verify the mail server is up, then iterate on agent accounts and rules.

- If you only need MCP tools (not the full CLI), install `@agenticmail/mcp` and wire it into your MCP client config for stdio transport.

### Source-backed notes

- README documents `npm install -g @agenticmail/cli` and the core commands `setup`, `start`, and `status` (with `--yes` for non-interactive runs).
- README states AgenticMail stores state in a SQLite DB at `~/.agenticmail/agenticmail.db` and (as of `@agenticmail/core@0.7.x`) uses Node’s built-in `node:sqlite` module.
- README lists an MCP package (`@agenticmail/mcp`) with dozens of tools for MCP-compatible clients.

### FAQ

- **Can I install it non-interactively?**: Yes — README documents `agenticmail setup --yes` for an auto-default install.
- **Where is the state stored?**: README says `~/.agenticmail/agenticmail.db` (SQLite).
- **Do I need the full stack to use MCP tools?**: Not necessarily — README lists `@agenticmail/mcp` as a standalone MCP server package.

## Source & Thanks

> Source: https://github.com/agenticmail/agenticmail
> License: MIT
> GitHub stars: 118 · forks: 21

---

<!-- ZH -->

## Quick Use

```bash
npm install -g @agenticmail/cli@latest
agenticmail setup --yes
agenticmail start
agenticmail status
# optional MCP-only install:
npm install -g @agenticmail/mcp@latest
```

## Intro

AgenticMail 提供 AI Agent 的邮件/短信基础设施：CLI 向导一键安装/启动，并内置 MCP server，让模型在权限边界内收发消息、排队审批、去重并追踪状态；状态落在本地 SQLite 便于审计。

**Best for:** 需要真实收件箱/发件箱与人工审批闭环的 agent

**Works with:** Node.js；Docker（邮件服务）；MCP 客户端；可调用工具的 Agent CLI

**Setup time:** 10-25 minutes

### Key facts (verified)

- GitHub：118 stars · 21 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`npm install -g @agenticmail/cli`。

## Main

- 用 `agenticmail setup --yes` 走非交互“安全默认值”安装路径，适合脚本化/agent 代装场景。

- 把 `agenticmail start` + 交互 shell 当作运维控制台：确认服务都起来后，再迭代账号、规则与审批流。

- 如果只需要 MCP 工具而不是完整 CLI，可安装 `@agenticmail/mcp`，按 stdio transport 配到 MCP 客户端即可。

### Source-backed notes

- README 写明 `npm install -g @agenticmail/cli`，并列出 `setup`/`start`/`status` 等核心命令（支持 `--yes` 非交互）。
- README 说明状态存储在 `~/.agenticmail/agenticmail.db` 的 SQLite 数据库中，并提到 `@agenticmail/core@0.7.x` 使用 Node 内置 `node:sqlite`。
- README 提供 `@agenticmail/mcp` 包，用于在 MCP 客户端中暴露大量工具。

### FAQ

- **能非交互安装吗？**：可以。README 提供 `agenticmail setup --yes` 的自动默认安装方式。
- **状态数据放在哪里？**：README 写的是 `~/.agenticmail/agenticmail.db`（SQLite）。
- **只用 MCP 工具需要装全套吗？**：不一定。README 列出 `@agenticmail/mcp` 可作为独立 MCP server 使用。

## Source & Thanks

> Source: https://github.com/agenticmail/agenticmail
> License: MIT
> GitHub stars: 118 · forks: 21


---
Source: https://tokrepo.com/en/workflows/agenticmail-email-sms-infra-for-ai-agents-mcp
Author: MCP Hub