Developers

An email API for AI agents, on the inboxes you already have

Connect Gmail, Outlook or any IMAP mailbox once. Your scripts, workflows and agents then read, search, draft and send from those real addresses over one HTTPS endpoint, with MCP and webhooks on the same key.

Read the developer guideSee pricing

What you get

Your real mailboxes

Gmail, Outlook and Microsoft 365, iCloud, Yahoo, Zoho, Fastmail with an app password, and any IMAP server. Agents work on the addresses your customers already know, with their history and their sender reputation. Nothing to migrate.

MCP and webhooks on one key

The endpoint that Claude and ChatGPT connect to also answers plain HTTPS from your code. On Pro and Business, a webhook starts your workflow when mail arrives, usually within about two minutes.

A flat price

Paid plans have a fixed monthly price and no per-call charge, so a busy workflow costs the same as a quiet one. Start free with one inbox.

Signed webhooks

Every delivery is signed with HMAC-SHA256 over a timestamp and the body, carries an event id for deduplication, and is retried up to six times when your endpoint does not answer.

Idempotent sends

Pass an idempotency_key and retry after a dropped connection without sending twice. The retry hands back the original message id.

Scoped keys

Each key holds only the permissions and inboxes it needs, so a triage script can read the support inbox and nothing else. Revoke one key without touching the others.

Send approval

Hold every send from an inbox until a person approves it. A good default while a new automation proves itself.

Open source

The server is open source, so you can read how each call is handled. You can also run it yourself.

How it works

  1. Connect a mailbox in the dashboard. Outlook signs in with Microsoft; most other providers take an app password.
  2. Create an API key, tick the scopes it needs and, if you like, pin it to some inboxes.
  3. Call tools/list to see what the key can do, then tools/call to read, search, draft or send.
  4. On Pro or Business, add a webhook endpoint so new mail reaches your workflow without polling.
bash
curl -s https://mcpemails.com/api/mcp \
  -H "Authorization: Bearer $MCPEMAILS_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "email_read",
      "arguments": { "action": "list", "inbox": "you@example.com", "unread": true, "limit": 20 }
    }
  }'

What developers build

  • n8n and other workflow tools: start a workflow on new mail, read it, and file, draft or reply.
  • Coding agents: give Claude Code a real inbox over HTTP with one command and a key.
  • Support and sales agents: triage a shared inbox, draft answers for a person to approve, follow up on schedule.
  • Your own agent: call the same tools from any language that can send an HTTPS request.

Connect an inbox and make your first call

One inbox is free, forever. No card required.