PlatformDocs
MCP server

test_email_account

Connects to the SMTP and IMAP servers with these settings and says whether sending and reading work, without saving anything.

View as Markdown

Test mailbox settings · Read-only · Acts outside your account

Connects to the SMTP and IMAP servers with these settings and says whether sending and reading work, without saving anything. Use it before add_email_account. Passwords are only used for the test.

ConnectionAccount URL, team member URL or OAuth

Parameters

ParameterTypeRequiredAcceptsDescription
smtpEmailstringYesanyLogin for sending, usually the mailbox address.
smtpHoststringYesanySMTP server, e.g. smtp.gmail.com.
smtpPortnumberYes1–65535SMTP port, e.g. 465 or 587.
smtpTLSbooleanYesanytrue for SSL/TLS.
imapEmailstringYesanyLogin for reading replies, usually the mailbox address.
imapHoststringYesanyIMAP server, e.g. imap.gmail.com.
imapPortnumberYes1–65535IMAP port, usually 993.
imapTLSbooleanYesanytrue for SSL/TLS.

Tool definition

What your assistant receives from tools/list:

{
  "name": "test_email_account",
  "title": "Test mailbox settings",
  "annotations": {
    "title": "Test mailbox settings",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "smtpEmail": {
        "type": "string",
        "description": "Login for sending, usually the mailbox address."
      },
      "smtpHost": {
        "type": "string",
        "description": "SMTP server, e.g. smtp.gmail.com."
      },
      "smtpPort": {
        "type": "number",
        "minimum": 1,
        "maximum": 65535,
        "description": "SMTP port, e.g. 465 or 587."
      },
      "smtpTLS": {
        "type": "boolean",
        "description": "true for SSL/TLS."
      },
      "imapEmail": {
        "type": "string",
        "description": "Login for reading replies, usually the mailbox address."
      },
      "imapHost": {
        "type": "string",
        "description": "IMAP server, e.g. imap.gmail.com."
      },
      "imapPort": {
        "type": "number",
        "minimum": 1,
        "maximum": 65535,
        "description": "IMAP port, usually 993."
      },
      "imapTLS": {
        "type": "boolean",
        "description": "true for SSL/TLS."
      }
    },
    "required": [
      "smtpEmail",
      "smtpHost",
      "smtpPort",
      "smtpPassword",
      "smtpTLS",
      "imapEmail",
      "imapHost",
      "imapPort",
      "imapPassword",
      "imapTLS"
    ]
  }
}

On this page