cpanel-mail-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IMAP_HOST | No | IMAP incoming mail server hostname (e.g., mail.example.com). | |
| IMAP_PORT | No | IMAP incoming mail server port (e.g., 993). | |
| MAIL_USER | No | cPanel email account username (e.g., usuario@example.com). | |
| SMTP_HOST | No | SMTP outgoing mail server hostname (e.g., mail.example.com). | |
| SMTP_PORT | No | SMTP outgoing mail server port (e.g., 465). | |
| SENT_MAILBOX | No | Custom sent mailbox name (e.g., INBOX.Sent). | |
| MAIL_ENV_FILE | No | Path to the environment file containing mail configuration (e.g., %USERPROFILE%\.config\cpanel-mail.env). | |
| MAIL_PASSWORD | No | cPanel email account password. | |
| TRASH_MAILBOX | No | Custom trash mailbox name (e.g., INBOX.Trash). | |
| DRAFTS_MAILBOX | No | Custom drafts mailbox name (e.g., INBOX.Drafts). | |
| MAIL_ALLOW_SEND | No | Whether to allow sending emails via SMTP. Defaults to false. | false |
| MAIL_ALLOW_EXPUNGE | No | Whether to allow permanent deletion of messages. Defaults to false. | false |
| MAIL_TLS_REJECT_UNAUTHORIZED | No | Whether to reject unauthorized TLS certificates. Defaults to true. | true |
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
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mail_config_statusA | Muestra la configuración pública del correo, sin la contraseña, y qué variables faltan. |
| check_connectionA | Inicia sesión en IMAP y comprueba la autenticación SMTP sin enviar correo. Úsala antes de organizar. |
| list_mailboxesA | Lista las carpetas IMAP con su ruta exacta, el uso especial (\Trash, \Sent, \Drafts, \Junk) y, si el servidor lo permite, el total y los no leídos. |
| unseen_summaryA | Devuelve solo las carpetas que tienen mensajes no leídos. Es el punto de partida para organizar. |
| mailbox_statusC | Cuenta mensajes, no leídos y recientes de una carpeta. |
| list_messagesA | Lista los mensajes más recientes de una carpeta: UID, fecha, remitente, asunto, banderas y si tiene adjuntos. No descarga el cuerpo. |
| get_messageA | Lee un mensaje por UID. Devuelve texto plano recortado y la lista de adjuntos. No lo marca como leído salvo mark_seen=true. Si el mensaje supera 2 MB, omite el cuerpo. |
| search_messagesA | Busca dentro de una carpeta. Exige al menos un criterio. since y before usan YYYY-MM-DD. Devuelve los UID más altos, que en cPanel suelen ser los más nuevos. |
| move_messagesA | Mueve mensajes por UID de una carpeta a otra. La destino tiene que existir; créala antes con create_mailbox. |
| set_flagsC | Añade o quita banderas: seen (leído), flagged (destacado), answered (respondido), deleted o draft. |
| create_mailboxA | Crea una carpeta IMAP y la suscribe. En cPanel usa un prefijo como INBOX.Clientes o INBOX.Facturas. |
| delete_messagesA | Mueve los UID a la papelera. Si ya están ahí, no los borra. permanent=true los expulsa solo si MAIL_ALLOW_EXPUNGE=true y la carpeta es la papelera. |
| save_attachmentA | Guarda un adjunto en un directorio local que ya exista. El índice sale de get_message. El nombre se sanea y no puede salir de ese directorio. |
| create_draftB | Guarda un borrador en la carpeta Drafts. No envía el correo. |
| send_messageA | Envía un correo por SMTP y guarda copia en Enviados. Falla si MAIL_ALLOW_SEND no es true. No lo uses sin un pedido explícito de la persona en este turno. |
| reply_messageA | Responde a un UID, cita el texto original y marca el mensaje como respondido. Exige MAIL_ALLOW_SEND=true y un pedido explícito de la persona. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| organizar_bandeja | Pide un plan para clasificar INBOX sin borrar nada de forma permanente. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Tools target distinct operations (e.g., list_messages vs get_message vs search_messages), but check_connection and mail_config_status both relate to connection/config status, and unseen_summary overlaps with list_mailboxes/mailbox_status by summarizing unread counts. Descriptions mostly clarify these boundaries.
Most names follow a consistent snake_case verb_noun pattern (list_mailboxes, get_message, create_mailbox), but a few diverge: check_connection and mail_config_status are noun/status-oriented, and unseen_summary uses a noun phrase rather than a verb. Still predictable overall.
16 tools is slightly heavy but appropriate for a full-featured IMAP/SMTP mail client covering connection, folders, messages, flags, attachments, drafts, and sending. Each tool has a plausible role, with only minor overlap (unseen_summary vs mailbox_status).
Covers the complete lifecycle: connect/check, list folders, list/read/search messages, move/delete, set flags, create folders, save attachments, drafts, send, reply, and config status. No obvious dead ends for mail management.