email_accounts_list
Lists the user's connected mailboxes with their id, address, provider (gmail, outlook, imap_smtp), connection status, Read/Write permission toggles, and per-provider capabilities. Call this first, in any session where you do not already hold an account_id. Every other tool in this server requires an explicit account_id and none of them will infer one — including the send tools, which never guess a sending mailbox. Read the result before acting: an account with read_enabled=false will refuse read tools, write_enabled=false will refuse writes, and the capabilities object tells you what the provider can actually do (for example can_permanently_delete is false on most IMAP servers, so email_delete_message will fail there rather than silently trashing).
Input fields
{
"type": "object",
"properties": {
"status": {
"description": "Filter by connection state. Omit to list all. Only 'connected' accounts can serve any other tool.",
"anyOf": [
{
"type": "string",
"enum": [
"connected",
"error",
"pending",
"revoked"
]
},
{
"type": "null"
}
]
},
"cursor": {
"description": "Opaque cursor from a previous response's next_cursor. Pass the same filters alongside it — a cursor is bound to the search that produced it.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"limit": {
"description": "Maximum results in this page. Clamped to the server maximum; omit for the server default.",
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
}
}Tool behavior
Declared read-only. Actual provider grants and account access apply.
Inspect isError and per-account errors. General write tools do not all enforce exact-plan approval. This reference does not certify any current AI client version.
YOUR INBOXES.
UNDER CONTROL.
Get started Start with a free account and one read-only search. Existing accounts keep their connection.