EmailInABox MCP Server
by jyswee
README.md
# eib
[](https://www.npmjs.com/package/emailinabox)
[](https://mcp.emailinabox.com/sse)
[](https://smithery.ai/servers/jyswee/emailinabox)
**Private email hosting your coding agent provisions itself. As easy as git.**
> **git for your code. eib for your email.**
Setting up email for a new domain still means a control panel, DNS records copy-pasted by hand, and SPF/DKIM/DMARC you hope you got right. `eib` is the mailserver your agent runs from the terminal: one command deploys a domain, creates the first mailbox, and auto-writes every DNS record — SPF, DKIM, DMARC, MX — so mail lands in the inbox, not spam. Then it tracks opens and clicks on everything you send.
**Works with:** Claude Code · Cursor · Cline · Windsurf · Aider · Codex · any MCP client
[](https://emailinabox.com/#demo)
*One command: deploy a domain, create the first mailbox, and auto-write SPF/DKIM/DMARC/MX. [Watch all the demos →](https://emailinabox.com/#demo)*
## Install
```bash
npm install -g emailinabox
```
The npm package is `emailinabox`; the command is `eib`.
## Quick Start
```bash
# Create a tenant and get an API key (a human starts the 7-day trial)
eib signup my-agency --email you@company.com --local
# Provision a domain + first mailbox — DNS (SPF/DKIM/DMARC/MX) auto-written
# The mailbox password is issued and printed once on completion.
eib deploy mycompany.com --email admin
# List what you have
eib domains
eib boxes
# Send a tracked email
eib send --from admin@mycompany.com --to lead@client.com \
--subject "Hello" --html "<p>Thanks for signing up.</p>"
# See opens and click-through
eib analytics
eib engagement 7d
# Full reference
eib --help
```
## Watch it work
Every core feature, end to end — the `eib` CLI on the left, the emailinabox dashboard on the right. **Click any GIF for the full-res video.**
| Deploy a domain | Mailboxes & aliases |
|---|---|
| [](https://prodmedia.tyga.host/public/tyga.cloud/landing/emailinabox.com/demo/deploy-demo.mp4) | [](https://prodmedia.tyga.host/public/tyga.cloud/landing/emailinabox.com/demo/mailboxes-demo.mp4) |
| `eib deploy` streams SPF/DKIM/DMARC/MX into place, then lands in the Domains view. | `eib box create` / `eib alias create`, mirrored in the Email boxes dashboard. |
| Send & track | Sign up & limits |
|---|---|
| [](https://prodmedia.tyga.host/public/tyga.cloud/landing/emailinabox.com/demo/send-demo.mp4) | [](https://prodmedia.tyga.host/public/tyga.cloud/landing/emailinabox.com/demo/signup-demo.mp4) |
| `eib send` with open/click tracking, surfaced in the Analytics view. | `eib signup` + `eib limits` — key issued, trial gating shown in the Overview. |
## No free tier — a real 7-day trial
`eib signup` issues your API key immediately, but it stays gated until a human starts the trial: pass `--email` and we send them a card-required checkout link. Nothing is charged during the 7 days — cancel before it ends and you pay nothing. Until a human activates, every provisioning call returns `402` with the payment URL, so an agent can always surface the link to its human but never spend money on its own.
```bash
eib signup acme --email founder@acme.com # -> returns eib_std_… key + paymentUrl
eib limits # plan tiers + what's gated
```
**Pricing:** $5/mailbox/month, up to 200 mailboxes on Standard, unlimited domains and aliases, 2,000 emails/day per mailbox, 30-day backups. Enterprise (unlimited mailboxes, 90-day backups) is custom. [Details](https://emailinabox.com).
## Domains — deploy with DNS done for you
```bash
eib deploy mycompany.com --email admin # first mailbox password is issued + printed once
eib domains # list domains + status
eib status mycompany.com # health check
eib dns mycompany.com # the exact records we wrote (SPF/DKIM/DMARC/MX)
eib dns-check mycompany.com # verify propagation
eib delete-domain mycompany.com
```
Provisioning streams step-by-step — mailserver, DKIM key generation, DNS records, verification — so you see exactly where it is, not a blind wait.
## Mailboxes & aliases
```bash
eib boxes # list mailboxes
eib box create sales@mycompany.com --password 'S3cure!'
eib box delete sales@mycompany.com
eib aliases # list aliases
eib alias create hello@mycompany.com --to admin@mycompany.com
eib alias delete ALIAS_ID
```
## Send & track
Send through your own domain and get open/click analytics on every message — no third-party ESP.
```bash
eib send --from admin@mycompany.com --to lead@client.com \
--subject "Your account is ready" --html "<p>Welcome aboard.</p>"
eib analytics # overview dashboard
eib engagement 30d # open/click rates over a period
eib opens 7d # timeline heatmap
```
## MCP Server
Prefer tools over a CLI? `eib` ships an MCP server. Point Claude Code (or any MCP client) at it and your agent gets **13 native tools**: deploy, domains, status, DNS, mailboxes, aliases, tracked send, analytics, engagement, and the admin suite.
```bash
claude mcp add emailinabox -- eib mcp-serve
```
For clients that use a JSON config (Cline, Cursor, Windsurf), pass your API key via the `EIB_API_KEY` environment variable. The MCP server runs outside your project directory, so it will not pick up `.eib/config.json`:
```json
{
"mcpServers": {
"emailinabox": {
"command": "eib",
"args": ["mcp-serve"],
"env": { "EIB_API_KEY": "eib_your_key_here" }
}
}
}
```
No key yet? Start it without one: the server boots in onboarding mode with `emailinabox_get_started` and `emailinabox_signup` tools that provision your account in-session, then unlock the full toolset once a human activates the trial.
### Remote MCP — zero install
No CLI at all? Claude Web, Claude Desktop, Raycast, or any hosted MCP client can connect straight to our remote server. Same 13 tools, same API key, nothing to install:
```
URL: https://mcp.emailinabox.com/sse
Auth: Authorization: Bearer YOUR_API_KEY (optional — keyless connections get the onboarding tools)
```
A keyless connection starts in onboarding mode and can self-signup, so directory listings (Smithery, Claude Web) work with zero configuration.
## Admin suite
With a superadmin key, `eib admin` exposes the full platform: tenants, users, anti-spam, cache, storage, revenue, and health.
```bash
eib admin overview # platform dashboard
eib admin tenants # all tenants
eib admin antispam # anti-spam overview
eib admin health # system health
eib admin billing # MRR / ARR / revenue
```
## Features
- **Domains** — one-command deploy with SPF/DKIM/DMARC/MX auto-configured, streaming provisioning, DNS propagation checks
- **Mailboxes & aliases** — full CRUD from the terminal
- **Tracked send** — send through your own domain, get open/click analytics, no third-party ESP
- **Analytics** — engagement rates, open timelines, per-period breakdowns
- **Admin** — tenants, users, anti-spam, cache, storage, revenue, health (superadmin key)
- **Support & platform** — tickets, audit trail, notifications, settings, branding
- **MCP server** — 13 tools, local (`eib mcp-serve`) or fully remote (`mcp.emailinabox.com`): Claude Code, Claude Web, Cursor, Raycast, any MCP client
## Config
```bash
eib signup my-project --local # new tenant, project-local key in .eib/config.json
eib login YOUR_KEY --local # save an existing key project-local (omit --local for global)
eib me # show active config + source
```
`--local` writes a project-local `.eib/config.json` (auto-loaded); add `.eib/` to your `.gitignore`. Project-local config takes precedence over the global key in `~/.eib/config.json`.
## Agent Integration
Add to your CLAUDE.md, .cursorrules, .clinerules, .windsurfrules, or AGENTS.md — or just drop in [`AGENTS.md`](./AGENTS.md):
```
## EmailInABox
This project uses EmailInABox for email hosting via the `eib` CLI.
Config is in .eib/config.json (auto-loaded).
If not configured: eib login YOUR_KEY --local
Run `eib --help` for every command. Provisioning is gated until a
human starts the 7-day trial — surface the paymentUrl, never guess.
```
## Documentation
- [Docs](https://emailinabox.com/docs)
- [emailinabox.com](https://emailinabox.com)
## License
Proprietary — Tyga.Cloud Ltd. See [LICENSE](./LICENSE).
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues