Skip to main content
Glama
rosauceda

cpanel-mail-mcp

by rosauceda

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_accountsA

List email accounts this caller can act on (no secrets returned).

In multi-user OAuth mode, only the caller's own account is returned; in single-tenant mode, all configured accounts appear.

list_foldersA

List every IMAP folder (mailbox) the account can see, UTF-7 decoded.

list_recentA

List the most recent messages in a folder (metadata only, newest first).

Use cursor (=previous next_cursor) to page further back in time.

search_emailsA

IMAP SEARCH over one field. Wraps query in quotes for IMAP.

Note: IMAP SEARCH is substring, case-insensitive on most servers, and doesn't support boolean operators. For richer queries, chain calls.

read_emailA

Fetch full headers + body of a message. Attachments listed by name+mime.

Set include_attachments=true to also embed each attachment as base64 (respects the size limit; large attachments may push you over context).

download_attachmentsA

Return message attachments as base64. Filter by filenames to save bytes.

get_threadB

Group messages sharing Message-ID / References / In-Reply-To headers.

send_emailA

Send an email. Supports HTML, attachments, and Save-to-Sent.

On retries after a client timeout, pass the same idempotency_key you used the first time to prevent duplicate delivery.

reply_emailA

Reply to a message. Preserves Message-ID linking + Subject Re: prefix.

reply_all=true includes the original To and Cc in the reply.

forward_emailA

Forward a message. Subject gets Fwd: prefix; original headers quoted.

save_draftB

Save an unsent draft in the account's Drafts folder.

send_inviteB

Send a calendar invite (RFC 5545 ICS, METHOD:REQUEST).

mark_readC

Add the \Seen flag.

mark_unreadC

Remove the \Seen flag.

star_emailB

Add the \Flagged (starred) flag.

unstar_emailC

Remove the \Flagged flag.

move_emailB

Move a message between folders (RFC 6851 MOVE with COPY+EXPUNGE fallback).

copy_emailB

Copy a message to another folder without removing the original.

delete_emailA

Delete a message. Soft-delete by default (moves to Trash).

create_folderA

Create a new IMAP folder and subscribe to it.

delete_folderA

Delete an empty IMAP folder. Fails if not empty (per RFC).

rename_folderC

Rename an IMAP folder.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 22 tools

Disambiguation5/5

Each tool targets a distinct action or resource. For example, star_email and unstar_email are opposites, and folder operations (create, delete, rename) are clearly separated. No overlapping purposes.

Naming Consistency4/5

Most tools follow a verb_noun pattern (e.g., send_email, create_folder). However, list_recent deviates slightly (verb_adjective), but it's still intuitive and the overall pattern is consistent.

Tool Count5/5

22 tools cover essential email operations without being excessive. Each tool has a clear purpose, and the number is well-scoped for a mail server.

Completeness5/5

The tool set covers email lifecycle: send, receive, search, organize folders, mark flags, and manage drafts. Missing features like spam handling are non-essential; core operations are complete.

Maintenance

ActivityStale
ResponsivenessNo issues