eib

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

Install

npm install -g emailinabox

The npm package is emailinabox; the command is eib.

Quick Start

# Create a tenant and get an API key (a human starts the 7-day trial)
eib signup my-agency --email [email protected] --local

# Provision a domain + first mailbox — DNS (SPF/DKIM/DMARC/MX) auto-written
eib deploy mycompany.com --email admin --password 'S3cure!'

# List what you have
eib domains
eib boxes

# Send a tracked email
eib send --from [email protected] --to [email protected] \
  --subject "Hello" --html "<p>Thanks for signing up.</p>"

# See opens and click-through
eib analytics
eib engagement 7d

# Full reference
eib --help

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.

eib signup acme --email [email protected]   # -> 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.

Domains — deploy with DNS done for you

eib deploy mycompany.com --email admin --password 'S3cure!'
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

eib boxes                             # list mailboxes
eib box create [email protected] --password 'S3cure!'
eib box delete [email protected]

eib aliases                           # list aliases
eib alias create [email protected] --to [email protected]
eib alias delete ALIAS_ID

Send & track

Send through your own domain and get open/click analytics on every message — no third-party ESP.

eib send --from [email protected] --to [email protected] \
  --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.

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:

{
  "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.

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

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:

## 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
• emailinabox.com

License

Proprietary — Tyga.Cloud Ltd. See LICENSE.