io.github.p-w-4-z/inbox-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| INBOX_MCP_HOST | No | IMAP server hostname (auto-detected if not provided) | |
| INBOX_MCP_PORT | No | IMAP port (default 993) | |
| INBOX_MCP_EMAIL | Yes | Your email address | |
| INBOX_MCP_PASSWORD | Yes | Password or app password | |
| INBOX_MCP_PROVIDER | No | Force provider: gmail, outlook, gmx, generic (auto-detected) | |
| INBOX_MCP_READ_ONLY | No | Set to true to disable write operations (default false) |
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 |
|---|---|
| get_summaryA | Get inbox statistics: total messages, unread count, and messages from the last 7 days. |
| list_messagesA | List messages from a mailbox folder. Args: folder: IMAP folder to read from (default: INBOX) filter: Message filter — 'all', 'unread', 'today', or 'week' (default: unread) limit: Maximum number of messages to return, up to 50 (default: 20) |
| read_messageA | Read the full body of a specific email by its sequence number. Args: message_id: The IMAP sequence number of the message (from list_messages) folder: IMAP folder containing the message (default: INBOX) |
| searchA | Search messages by subject or sender. Args: query: Search term to look for in subject and sender fields folder: IMAP folder to search in (default: INBOX) limit: Maximum number of results, up to 50 (default: 20) |
| list_foldersA | List all available IMAP folders/labels in the email account. |
| mark_readA | Mark one or more messages as read (sets the IMAP Seen flag). Args: message_ids: List of IMAP sequence numbers to mark as read folder: IMAP folder containing the messages (default: INBOX) |
| move_messageA | Move one or more messages to a different folder. Creates the target folder if needed. Args: message_ids: List of IMAP sequence numbers to move target_folder: Destination IMAP folder source_folder: Source IMAP folder (default: INBOX) |
| create_folderB | Create a new IMAP folder. Args: folder_name: Name of the folder to create (e.g. 'Archive/2024') |
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 8 tools
Each tool has a clearly distinct purpose: folder creation, summary stats, folder listing, message listing, marking read, moving, reading, and searching. No overlaps.
All tool names follow a consistent verb_noun snake_case pattern (e.g., create_folder, list_messages, mark_read). 'search' is a verb but fits the pattern.
8 tools cover the core inbox management operations without bloat. The count is appropriate for the domain.
Covers main actions: folder creation, listing, message reading, marking read, moving, searching. Missing delete/mark unread/send are minor gaps but not critical for the stated purpose.