mcp-imap-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IMAP_HOST | Yes | The hostname of the IMAP server | |
| IMAP_PORT | Yes | The port of the IMAP server | |
| IMAP_USER | Yes | The email address for IMAP authentication | |
| IMAP_PASSWORD | Yes | The password for IMAP authentication |
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 | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_foldersB | List all IMAP mailbox folders |
| list_messagesC | List recent messages in a folder with subject, from, date. Default folder is INBOX. |
| get_messageA | Fetch a single email by UID. Returns headers and text body (prefers plain text). |
| search_messagesC | Search messages in a folder by criteria (subject, from, since date, unseen only) |
| mark_messageC | Set or remove flags on a message (e.g., mark as read/unread, flag/unflag) |
| move_messageC | Move a message to another folder |
| delete_messageA | Delete a message (move to Trash or permanently delete) |
| create_reply_draftB | Create a reply draft on an existing email thread. Finds the message by UID, sets In-Reply-To and References headers to keep it in the same thread. |
| create_draftC | Create a draft email in the Drafts folder |
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 9 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools like create_draft and create_reply_draft are closely related but serve different functions (new draft vs. reply), while others like delete_message, move_message, and mark_message each handle specific message operations without overlap.
All tools follow a consistent verb_noun pattern with snake_case throughout (e.g., create_draft, list_folders, search_messages). There are no deviations in naming conventions, making the set predictable and readable.
With 9 tools, the count is well-scoped for an IMAP email server. Each tool earns its place by covering essential email operations like listing, creating, managing, and searching messages, without being excessive or too sparse.
The tool set provides complete CRUD/lifecycle coverage for email management: create (drafts/replies), read (get/list/search), update (mark/move), and delete (delete_message). It covers all core workflows from folder listing to message handling with no obvious gaps.