IMAP Email

Read and manage emails from any IMAP-compatible email provider

Overview

The IMAP Email server provides read and management access to any IMAP-compatible email provider, including self-hosted servers. It supports searching, reading, organizing, and managing emails across folders.

Read-only by design: This server cannot send or compose emails. It is designed for reading and managing existing emails only.

How to Add IMAP Email

1. Add Server

   Add the IMAP Email server to your Nexus environment through the server directory.

2. Configure Credentials

   Provide your IMAP connection details:

   • IMAP host — your email provider’s IMAP server
   • Username — your email address
   • Password — your password or app-specific password
   • Port — usually 993 for SSL (default)
3. Test Connection

   Try “List all my email folders” to verify the connection works.

App-specific passwords: Some email providers with 2FA enabled require app-specific passwords instead of your regular password. Check your email provider’s security settings if you have trouble connecting.

What You Can Do

Email Search & Reading

Search with multiple filters and read full email content including headers

Folder Management

List folders, check status, and navigate your mailbox structure

Attachments

List and download attachments from any email

Email Organization

Move, copy, delete, flag, and mark emails as read/unread

Available Tools (12)

Folder Operations

list_folders

List all folders/mailboxes in the account. Use this to discover available folder names before other operations.

get_folder_status

Get folder statistics including total message count, unread count, and recent messages.

Reading Emails

list_emails

List emails in a folder with pagination. Returns email UIDs, subjects, senders, and dates.

get_email

Fetch complete email content including subject, sender, recipients, body, and metadata.

get_email_headers

Lightweight header-only fetch for quick previews without downloading full message content.

Searching

search_emails

Advanced search with multiple filters including sender, recipient, subject, body text, date range, read/unread status, and flagged state.

Attachments

list_attachments

List attachment metadata (filename, size, type) for a specific email.

get_attachment

Download a specific attachment from an email by its index.

Managing Emails

delete_emails

Delete one or more emails. By default moves to Trash; use permanent=true for permanent deletion.

move_emails

Move one or more emails to a different folder.

copy_emails

Copy one or more emails to a different folder while keeping the originals.

mark_emails

Mark emails as read/unread or flagged/unflagged. Supports batch operations on multiple UIDs.

Use Cases

Inbox overview

“Show me my latest 10 emails” — List recent messages with subjects and senders.

Unread triage

“List all unread emails in my inbox” — Quickly see what needs attention.

Targeted search

“Find all emails from [e-mail] with ‘invoice’ in the subject since January 1st” — Combine multiple search filters.

Attachment retrieval

“List attachments in email UID 12345 and download the PDF” — Discover and download file attachments.

Bulk organization

“Move emails 123, 456, and 789 to the Archive folder” — Batch operations for efficient inbox management.

Flagging important messages

“Flag email UID 12345 as important and mark emails 100, 101, 102 as read” — Update message status in bulk.

Email UIDs: Most operations use email UIDs (unique identifiers). Use list_emails or search_emails first to get UIDs before reading or managing specific emails.

Folder names: Use list_folders to discover available folder names. Common folders include INBOX, Sent, Drafts, Trash, and Archive, but names vary by provider.

Batch operations: Delete, move, copy, and mark operations support multiple UIDs at once for efficiency.

Date format: Use YYYY-MM-DD format for date searches (e.g. 2025-01-15).