stackgate.ai
All integrations

Email

Read and send email over IMAP/SMTP — connect multiple mailboxes with provider presets.

Manual setup 5 tools

Overview

Read and send email over IMAP and SMTP for any provider — connect multiple mailboxes with provider presets or custom server settings.

Distinct from Gmail, which uses Google OAuth and the Gmail API. Use Email for Simply.com, One.com, Fastmail, Microsoft 365, and other IMAP/SMTP hosts.

Prerequisites

  • An email account with IMAP and SMTP enabled
  • Mailbox password (or app-specific password for iCloud and some providers)
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai and open Integrations → Email.
  2. Click Activate and add one or more mailboxes.
  3. Choose a provider preset (e.g. Simply.com) or Custom to enter IMAP/SMTP settings manually.
  4. Enter mailbox ID, label, email address, and password.
  5. Save — the hub verifies IMAP and SMTP login before enabling the integration.

Simply.com example

  • IMAP: mail.simply.com, port 993, SSL
  • SMTP: smtp.simply.com, port 587, TLS (STARTTLS)
  • Username: your full email address

iCloud Mail

Generate an app-specific password — do not use your main Apple ID password.

Using with AI clients

  • Dedicated endpoint: POST /mcp/email
  • Private gateway: email__* tools

Typical workflow: list-mailboxes-tool → list-folders-tool → list-messages-tool → get-message-tool / send-message-tool.

Always pass mailbox, folder, and uid together when reading a message.

Troubleshooting

  • Authentication failed — verify email address and password; for iCloud use an app-specific password.
  • SMTP send failures — confirm SMTP host, port, and encryption match your provider docs.
  • Empty search results — IMAP search runs within one folder; try INBOX and broaden filters.

Available tools

  • list-mailboxes-tool

    List configured email mailboxes for this account (id, label, email_address).

  • list-folders-tool

    List IMAP mail folders for a configured mailbox.

  • list-messages-tool

    List or search messages in a mail folder. Returns summaries; use get-message-tool for full content.

  • get-message-tool

    Get a message by mailbox, folder, and IMAP UID, including headers and body.

  • send-message-tool

    Send an email from a configured mailbox. Supports plain text or HTML body.

MCP endpoint: https://stackgate.ai/mcp/email (HTTP) or via the private gateway.

Create account Documentation