Documentation

Three ways to interact with your email

Whether you're building AI agents, automating workflows, or integrating email into your product — pick the interface that fits your stack.

The universal interface

REST API

A clean, RESTful API that normalizes every email provider into a single consistent interface. Send, read, search, and manage email across Gmail, Outlook, and any IMAP provider — all through one endpoint.

Unified endpoint for all providers
JSON request and response bodies
Bearer token authentication
Pagination, filtering, and full-text search
Webhook subscriptions for real-time events
OpenAPI/Swagger documentation included

Send an email

curl -X POST https://api.inbox-api.com/v1/send \
  -H 'Authorization: Bearer tok_...' \
  -H 'Content-Type: application/json' \
  -d '{"to": "team@acme.com", "subject": "Q3 Report", "body": "<h1>Hello</h1>"}'

Search messages

curl https://api.inbox-api.com/v1/messages?q=invoice \
  -H 'Authorization: Bearer tok_...'

// Response
{
  "messages": [
    {
      "id": "msg_abc123",
      "from": "billing@vendor.com",
      "subject": "Invoice #1042",
      "snippet": "Please find attached...",
      "date": "2026-03-20T14:30:00Z",
      "hasAttachments": true
    }
  ],
  "nextCursor": "cur_xyz789"
}

Built for AI agents

MCP Server

Native Model Context Protocol support means Claude, GPT, and any MCP-compatible agent can read, send, and manage email through standard tools — no custom integration code, no credential exposure.

Standard MCP tool interface
Works with Claude, GPT, and any MCP client
Scoped permissions per agent
Thread-aware conversations
Search across all connected accounts
Zero credential exposure to LLMs

Configuration

// claude_desktop_config.json
{
  "mcpServers": {
    "inbox-api": {
      "command": "npx",
      "args": ["inbox-api-mcp"],
      "env": {
        "INBOX_API_TOKEN": "tok_..."
      }
    }
  }
}

Available tools

// Available MCP tools
list_messages    — Search and list emails across accounts
get_message      — Read a full email with attachments
get_thread       — Get an entire conversation thread
send_email       — Compose and send a new email
reply            — Reply to an existing message
create_draft     — Save a draft for later review
search           — Full-text search across all accounts
archive          — Archive or move messages

For automation and scripting

CLI

A full-featured command-line interface for managing email accounts, sending messages, and automating workflows. Pipe-friendly output, scriptable commands, and shell completion built in.

Manage accounts and tokens from the terminal
Send and read email with simple commands
JSON output for scripting and pipelines
Shell completion for bash, zsh, and fish
Cron-friendly for scheduled tasks
Configure webhooks and sync settings

Terminal

# Add an email account
$ inbox-api accounts add --provider gmail --email me@gmail.com

# Create a scoped API token
$ inbox-api tokens create --name "my-agent" --scopes read,send

# Search your inbox
$ inbox-api messages list --query "from:boss@company.com" --json

# Send an email
$ inbox-api send --to team@acme.com --subject "Update" --body "All done."

Available at launch

Be the first to know when we launch

Join the waitlist