exmail-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_DIR | No | Data directory. Default is <data dir>. | |
| MCP_HOST | No | Native HTTP listen address (default 127.0.0.1). The Docker image listens on 0.0.0.0 inside the container. | 127.0.0.1 |
| MCP_PORT | No | Native HTTP listen port (default 8765). | 8765 |
| SEND_LOG | No | Send log file. Default is send_log.jsonl. | |
| DRAFT_DIR | No | Local drafts directory. Default is <DATA_DIR>/drafts. | |
| DRAFT_LOG | No | Draft log file. Default is draft_log.jsonl. | |
| SENT_COPY | No | Controls Sent-folder copying after sending: auto (default) appends only if missing; append always appends; off never appends. | auto |
| ATTACH_DIR | No | Directory for outgoing attachments. Default is <DATA_DIR>/attachments. Outgoing attachments must be inside this directory. | |
| DISPLAY_TZ | No | IANA timezone for date_iso fields (default UTC; e.g. Asia/Shanghai or America/New_York). date_utc is always UTC. | UTC |
| EXMAIL_USER | Yes | Mailbox address. Required. | |
| MCP_BIND_IP | No | Docker only: host address to publish on. Use 127.0.0.1 or a private VPN/Tailscale IP. Never use 0.0.0.0 or a public IP. | |
| DOWNLOAD_DIR | No | Download directory for attachments. Default is <DATA_DIR>/downloads. | |
| CONTACTS_FILE | No | Optional contacts file. Default is <config dir>/contacts.json. | |
| IMAP_POOL_SIZE | No | Read-only connection pool size (default 3). | 3 |
| MCP_TOKEN_FILE | No | Bearer token file (HTTP only). Native default is <config dir>/mcp_token. Docker default is ./secrets/mcp_token. | |
| ATTACH_DIR_HOST | No | Docker only: host path of the outgoing attachments directory reported back to clients. | |
| SEARCH_SCAN_CAP | No | Advanced: maximum newest candidates scanned per search call (default 3000). | 3000 |
| EXMAIL_FROM_NAME | No | Optional display name for the From header. | |
| EXMAIL_IMAP_HOST | No | Advanced: Exmail IMAP host override. | |
| EXMAIL_IMAP_PORT | No | Advanced: Exmail IMAP port override. | |
| EXMAIL_PASS_FILE | No | Password file. Native default is <config dir>/exmail.pass. Docker: host path of the file, mounted read-only at /run/secrets/exmail.pass. | |
| EXMAIL_SMTP_HOST | No | Advanced: Exmail SMTP host override. | |
| EXMAIL_SMTP_PORT | No | Advanced: Exmail SMTP port override. | |
| HEADER_CACHE_DIR | No | Header cache directory. Default is hcache. | |
| HEADER_CACHE_MAX | No | Advanced: maximum header cache entries (default 50000). | 50000 |
| MAX_ATTACH_BYTES | No | Advanced: maximum attachment size (default 25 MB). | 25 MB |
| DISK_HEADER_CACHE | No | Advanced: enable or disable the disk header cache (default on; set off to disable). | on |
| DOWNLOAD_DIR_HOST | No | Docker only: host path of the downloads directory reported back to clients. | |
| SENT_WAIT_SECONDS | No | Advanced: seconds to wait when checking for the Sent copy (default 20). | 20 |
| WARM_HEADER_CACHE | No | Advanced: enable or disable background header cache warm-up (default on; set off to disable). | on |
| EXMAIL_MCP_DATA_DIR | No | Per-user data folder override. | |
| EXMAIL_MCP_CONFIG_DIR | No | Per-user config folder override. | |
| IMAP_POOL_IDLE_SECONDS | No | Idle drop time for pooled IMAP connections in seconds (default 240). | 240 |
| IMAP_POOL_NOOP_SECONDS | No | Advanced: interval for NOOP checks on idle pooled IMAP connections in seconds (default 30). | 30 |
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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues