Octopus — Planned
Email Plugin (Planned)
The planned Email plugin will allow Octopus agents to read email inboxes, draft and send messages, and reply to conversations — using IMAP for reading and SMTP/SendGrid/Outlook for sending.
Planned feature. This plugin is in the design phase. The API described here reflects the current design intent and may change before release.
Planned MCP Tools
| Tool | Description |
|---|---|
email_list_inbox | List recent inbox messages with subject, sender, and date |
email_read | Read the full content of a specific email by message ID |
email_send | Send a new email to one or more recipients |
email_reply | Reply to an existing email thread |
email_search | Search emails by keywords, sender, date range, or folder |
email_move | Move a message to a folder (archive, spam, etc.) |
Design Sketch
// Planned configuration shape
{
"EmailPlugin": {
"Provider": "SMTP", // SMTP | SendGrid | Outlook | Gmail
"InboundProvider": "IMAP", // IMAP | Outlook | Gmail
"CredentialId": 30, // ICredentialResolver — stores connection string
"AllowedRecipients": ["*@company.com"], // Allowlist for outbound email
"MaxEmailsPerHour": 10 // Rate limit for outbound sends
}
}Security Considerations
- All credentials (SMTP password, SendGrid API key, OAuth tokens) via
ICredentialResolver— never in config - Outbound email allowlist: agents can only send to approved domains or addresses
- Rate limiting: agents cannot send more than
MaxEmailsPerHouremails per conversation session - Agent must confirm send with user before calling
email_send - No email forwarding to external addresses without explicit operator approval
Supported Providers (Planned)
| Provider | Read | Send | OAuth Support |
|---|---|---|---|
| SMTP + IMAP | Yes | Yes | No (basic auth) |
| SendGrid | No | Yes | API Key |
| Microsoft Outlook | Yes | Yes | Yes (Azure AD) |
| Gmail | Yes | Yes | Yes (Google OAuth) |