Email

Email tools are available through the OneMail MCP endpoint.

POST https://mail.onehelio.com/mcp

The endpoint requires an Auth0 bearer token or a OneMail API key.

Required headers

Authorization: Bearer <onemail-token-or-api-key>
Content-Type: application/json
Accept: application/json, text/event-stream

Tools

Tool	Purpose
list_messages	List recent messages by folder or search text
get_message	Read one owned message
send_email	Send an email and store the sent copy
delete_email	Delete a message using OneMail semantics
move_email	Move a message to a folder
create_calendar_event	Create a calendar event
modify_calendar_event	Update a calendar event
delete_calendar_event	Delete a calendar event
search_contacts	Search contacts by email or display name
list_shared_mailboxes	List shared mailboxes the user can access
list_groups	List distribution groups the user belongs to or owns

List messages

curl https://mail.onehelio.com/mcp \
  -H "Authorization: Bearer $ONEMAIL_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_messages",
      "arguments": {
        "limit": 3
      }
    }
  }'

Search contacts

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": {
      "query": "test",
      "limit": 5
    }
  }
}