API Overview
email-connector exposes two types of interfaces: MCP tools (used by Claude) and HTTP endpoints (used during OAuth and monitoring).Base URL
MCP Tools
These are the tools Claude uses to interact with your email. You don’t call them directly — Claude invokes them based on your natural language requests.| Tool | Description |
|---|---|
get_recent_emails | Fetch recent emails from any folder |
search_emails | Search by sender, subject, date, or keyword |
get_email | Get full content of a specific email |
list_mailboxes | List all folders/mailboxes |
list_providers | List supported email providers |
draft_email | Compose a draft without sending |
send_email | Send an email via SMTP |
mark_as_read | Mark a message as read |
move_email | Move a message to another folder |
HTTP Endpoints
| Endpoint | Method | Auth | Purpose |
|---|---|---|---|
/mcp | POST | Bearer | MCP Streamable HTTP transport |
/mcp | GET | Bearer | SSE streaming for active sessions |
/mcp | DELETE | Bearer | Close an MCP session |
/oauth/authorize | GET | None | Start OAuth flow |
/oauth/connect | POST | None | Submit email credentials |
/oauth/token | POST | Client | Exchange code for token |
/oauth/revoke | POST | None | Revoke an access token |
/oauth/meta | GET | None | RFC 8414 server metadata |
/health | GET | None | Health check |
Authentication
All MCP endpoints require a Bearer token obtained through the OAuth flow:client_id and client_secret for client authentication during token exchange.
Transport
email-connector uses Streamable HTTP — the current recommended MCP transport. The session lifecycle is:POST /mcpto initialize (returnsMcp-Session-Idheader)GET /mcpwithMcp-Session-Idfor SSE streamingPOST /mcpwithMcp-Session-Idto send subsequent messagesDELETE /mcpwithMcp-Session-Idto close