IMAP Mail MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IMAP_HOST | Yes | IMAP host | |
| IMAP_PASS | Yes | IMAP password | |
| IMAP_PORT | Yes | IMAP port | |
| IMAP_USER | Yes | IMAP username | |
| IMAP_SECURE | Yes | true for TLS, false for plain | |
| MAIL_MAX_RESULTS | No | global cap for list/search limits, default 200 | |
| MAIL_SNIPPET_LENGTH | No | max snippet chars when enabled, default 400 | |
| MAIL_MAX_BODY_LENGTH | No | max body chars in mail_get_message, default 50000 | |
| IMAP_TLS_REJECT_UNAUTHORIZED | No | validate TLS cert chain, default false for local self-signed |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mail_list_foldersA | List all mail folders (mailboxes). Use this to see INBOX, Sent, etc. |
| mail_list_messagesA | List recent messages in a folder (envelope only by default). Supports sort/cursor/snippet options. |
| mail_get_messageA | Fetch one full message by folder and UID (envelope + body text). |
| mail_searchA | Convenience folder search by basic fields. Prefer mail_search_advanced for richer filters and agent reliability. |
| mail_search_advancedC | Primary advanced search tool: keyword, sender/receiver, subject/body, date/date-range, sent-date-range, read state, message-id. |
| mail_get_mailbox_statusA | Get message counters for one folder (messages, unseen, recent, UID metadata). |
| mail_list_unreadA | List unread messages in a folder (envelope only by default). Supports sort/cursor/snippet options. |
| mail_list_attachmentsA | List attachment metadata for one message by folder and UID (no binary download). |
| mail_query_by_folderB | Convenience free-text query in one folder. Prefer mail_search_advanced for canonical searches. |
| mail_get_thread_contextA | Get related messages in the same thread context using Message-ID/References/In-Reply-To. Includes snippets by default. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools have distinct purposes, but the three search tools (mail_query_by_folder, mail_search, mail_search_advanced) have overlapping functionality, which could lead to confusion despite the descriptions advising preference for mail_search_advanced.
The naming pattern is mostly 'mail_verb_noun' but uses inconsistent verbs (get vs list vs query) and mixes conventions between retrieval actions, creating slight inconsistency.
With 10 tools, the set is well-scoped for an IMAP-focused server, covering the essential operations for reading and searching emails without being excessive.
The server covers reading, searching, and thread context well, but notable gaps exist for common IMAP actions like marking messages as read/unread, deleting, or moving messages.