bg-imapMCPSever
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IMAP_HOST | Yes | IMAP DNS name (required) | |
| IMAP_PORT | No | TLS IMAP port | 993 |
| IMAP_TIMEOUT | No | IMAP socket timeout in seconds | 20 |
| IMAP_PASSWORD | Yes | Mailbox/app password (required; an app-specific password is preferable if supported) | |
| IMAP_USERNAME | Yes | Mailbox login (required) | |
| IMAP_MAX_RESULTS | No | Hard cap for listing/search results | 50 |
| IMAP_DEFAULT_FOLDER | No | Reserved default folder setting | INBOX |
| IMAP_MAX_BODY_CHARS | No | Cap on returned message body characters | 20000 |
| IMAP_MAX_MESSAGE_BYTES | No | Cap on fetched message size in bytes | 3000000 |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| check_connectionA | Test authenticated IMAP connectivity; never return credentials. |
| list_foldersA | List IMAP folders (raw server entries; flags and quoted names may be present). |
| folder_statusB | Count total and unread messages in a folder without marking any read. |
| list_messagesB | List newest message headers by stable IMAP UID (max configured cap). |
| search_messagesC | Search mailbox TEXT for plain text query, returning matching headers and UIDs. |
| read_messageA | Read text content and attachment metadata by folder and UID; does not mark read. |
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 6 tools
Each tool has a clearly distinct purpose: connectivity check, folder listing, folder statistics, message listing, message search, and message reading. There is no meaningful overlap between tools, so an agent can easily select the right one.
All tool names use snake_case consistently. Most follow a verb_noun pattern, though folder_status is noun-based rather than verb-based, which is a minor deviation but still clear.
Six tools is well-scoped for a read-only IMAP interface, with each tool covering a distinct step in the email access workflow. No tool feels redundant or unnecessary.
The server covers the core read path: connection, folders, status, listing, search, and reading. However, it lacks common IMAP lifecycle operations such as flag updates, moving/deleting messages, folder management, and attachment retrieval, which would limit agents needing write or maintenance tasks.