Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| connect | Establish IMAP connection to mail server |
| authenticate | Login with username and password |
| disconnect | Close IMAP connection |
| auto_connect | Connect using config.json credentials (no parameters needed) |
| list_mailboxes | List all mailbox folders |
| select_mailbox | Select/open a mailbox folder |
| create_mailbox | Create a new mailbox folder |
| get_mailbox_status | Get mailbox status (message count, unseen, etc.) |
| fetch_emails | Fetch emails from mailbox with optional filters |
| get_email | Get complete email by UID |
| get_email_headers | Get only email headers (faster) |
| get_email_body | Get email body content |
| get_attachments | List attachments of an email |
| download_attachment | Download attachment content (base64) |
| get_thread | Get email thread/conversation |
| search_emails | Search emails with query |
| search_by_sender | Search emails by sender address |
| search_by_subject | Search emails by subject |
| search_by_date | Search emails by date range |
| search_unread | Get all unread emails |
| search_flagged | Get all flagged/starred emails |
| mark_read | Mark emails as read |
| mark_unread | Mark emails as unread |
| flag_email | Add flag to emails |
| unflag_email | Remove flag from emails |
| move_email | Move emails to another mailbox |
| copy_email | Copy emails to another mailbox |
| archive_email | Archive emails (move to Archive folder) |
| save_draft | Save email as draft (automatically includes user signature from config) |
| get_unread_count | Get count of unread emails |
| get_total_count | Get total email count in mailbox |
| get_cached_overview | Get cached email overview for INBOX, next, waiting, someday (from in-memory cache) |
| refresh_cache | Force refresh of email cache for all watched mailboxes |
| start_watch | Start permanent IDLE watch on INBOX, next, waiting, someday |
| stop_watch | Stop the permanent IDLE watch |
| idle_watch | Start watching mailbox for new emails (IMAP IDLE) - single mailbox, temporary |
| get_auto_archive_list | Get list of senders that are auto-archived |
| add_auto_archive_sender | Add sender to auto-archive list |
| remove_auto_archive_sender | Remove sender from auto-archive list |
| reload_auto_archive | Reload auto-archive config from file (after manual edit) |
| process_auto_archive | Process INBOX and archive emails from listed senders. Use dry_run=true to preview without moving. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |