Skip to main content

Description

Returns metadata for all configured IMAP accounts. Credentials are intentionally excluded from the response for security.
This tool requires no input parameters and lists all accounts configured via environment variables.

Input Parameters

This tool accepts no input parameters.

Response

summary
string
required
Human-readable summary of the operation outcome.Example: "2 account(s) configured"
data
object
required
meta
object
required
Execution metadata.

Examples

{
  "method": "tools/call",
  "params": {
    "name": "imap_list_accounts",
    "arguments": {}
  }
}

Environment Variables

Accounts are configured using environment variables:
  • MAIL_IMAP_<ACCOUNT>_HOST (required) - IMAP server hostname
  • MAIL_IMAP_<ACCOUNT>_PORT (default: 993) - IMAP server port
  • MAIL_IMAP_<ACCOUNT>_SECURE (default: true) - Enable TLS
  • MAIL_IMAP_<ACCOUNT>_USER (required) - Username/email
  • MAIL_IMAP_<ACCOUNT>_PASS (required) - Password/app password
Where <ACCOUNT> is the uppercase account ID (e.g., DEFAULT, WORK).

Error Cases

This tool does not fail. If no accounts are configured, it returns an empty array.

Build docs developers (and LLMs) love