SMTP Toolkit
The SMTP toolkit lets agents send email through a standard SMTP server. Configure host and port (and optional username/password with TLS/SSL) as a saved connection.
Add it on the agent Toolkits tab and create or select an SMTP connection.
Prerequisites
- SMTP host and port for your mail provider
- Optional: mailbox username and password (or app password) if the server requires auth
- An agent you can edit
Setup
- Open the agent → Toolkits → add SMTP.
- Create a connection with host and port (required), plus email / password and TLS/SSL if needed.
- Save the agent.
@-mention the SMTP send tool when the agent should email someone.
Available tools
| Tool | Description |
|---|---|
| Send Email | Sends an email through the configured SMTP server. |
Use cases
- Send a summary or alert from chat to a stakeholder
- Notify a distribution list after a workflow completes
Tips
- Prefer app passwords or SMTP credentials scoped to sending only.
- Store credentials in a saved connection — do not put them in the personality prompt.
- For Gmail or Outlook with OAuth toolkits, prefer those when available.
Troubleshooting
| Symptom | What to check |
|---|---|
| Connection refused / timeout | Host, port, firewall, and TLS vs SSL settings |
| Auth failed | Username/password or app password; some providers require SMTP to be enabled |
| Message rejected | From address allowed by the server; recipient address validity |