Connect an SMTP email server to ORQO so that agents can send emails as part of workflow execution.
| Category | Communication |
| Capabilities | Send only |
| Adapter path | /email |
| Auth method | SMTP credentials |
Email is a send-only integration. Agents can send emails through workflows, but ORQO does not receive inbound emails.
Prerequisites
- An SMTP server or email service provider (Gmail, SendGrid, Mailgun, Amazon SES, etc.)
- SMTP credentials (host, port, username, password)
- Access to the ORQO Settings area
Setup
1. Gather SMTP Credentials
You need the following from your email provider:
| Setting | Example |
|---|---|
| SMTP host | smtp.gmail.com |
| SMTP port | 587 (TLS) or 465 (SSL) |
| Username | your-email@example.com |
| Password | App-specific password or API key |
For Gmail, create an App Password under your Google Account security settings. Regular passwords will not work if 2FA is enabled.
2. Install the Email App in ORQO
- Navigate to Settings > Apps in ORQO.
- Find Email in the app catalog and click Install.
- The app is created with the correct adapter URL and capabilities.
3. Add Credentials
After installation, the credentials checklist shows what's required:
| Credential | Type | Description |
|---|---|---|
| EMAIL_SMTP | smtp | SMTP connection details (host, port, username, password) |
Create the credential in Settings > Credentials, then assign it to the Email App.
4. Verify the Connection
Click Verify on the Email app card in ORQO. This tests the SMTP connection to confirm that the credentials are valid and the server is reachable.
Available Tools
The Email adapter exposes MCP tools that agents can use in workflows:
| Tool | Description |
|---|---|
send_email | Send an email with a subject, body, and recipients |
This tool is discovered automatically when the App is verified and can be assigned to agents via Skills.
Platform-Specific Behavior
- Send only — ORQO sends outbound emails but does not process inbound emails. For receiving messages, use a messaging platform like Slack, WhatsApp, or Telegram.
- HTML and plain text — The
send_emailtool supports both HTML and plain text message bodies. - Multiple recipients — Emails can be sent to multiple recipients in a single call.
What's Next
- Apps & Channels for the full architecture
- Create a Skill to bundle the email tool for agents
- Set Up Assignments to give agents access to email in workflows