Skip to main content
Glama
Guascoign

Mail Notification MCP

by Guascoign
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
IMAP_HOSTNoThe IMAP server host. Overrides imap.host in config.json.
IMAP_PASSNoThe IMAP password. If not set, the SMTP password (MAIL_SMTP_PASSWORD or smtp.password) is reused. Overrides imap.password in config.json.
IMAP_PORTNoThe IMAP server port. Overrides imap.port in config.json. Default is 993.
IMAP_USERNoThe IMAP username. Overrides imap.username in config.json.
NOTIFY_TONoThe default recipient email for notifications. Overrides notification.to in config.json.
IMAP_SECURENoWhether to use a secure SSL/TLS IMAP connection. Overrides imap.secure in config.json. Should be 'true' or 'false'.
MAIL_SMTP_PASSWORDNoThe SMTP password or app-specific password. Used as the password for both SMTP and IMAP if IMAP_PASS is not set. Overrides the smtp.password in config.json.

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
send_simple_emailB

Send a simple email.

    Args:
        to: Recipient email address
        subject: Email subject
        body: Email body content
        is_html: Whether body is HTML (default: False)
        smtp_config: Optional SMTP configuration override with:
            - host: SMTP server hostname
            - port: SMTP server port
            - secure: Use SSL/TLS
            - username: Auth username
            - password: Auth password
            - from_email: Sender email address
            Falls back to environment variables if not provided.

    Returns:
        Success message or error message
send_custom_emailA

Send a custom email with full configuration options.

    Args:
        email: Email message details including:
            - to: Recipient email address(es) (string or list)
            - cc: CC email address(es) (optional, string or list)
            - bcc: BCC email address(es) (optional, string or list)
            - subject: Email subject
            - text: Plain text email body (optional)
            - html: HTML email body (optional)
            - attachments: List of attachments (optional), each with:
                - path: Local file path to attach (preferred)
                - content: Base64-encoded file content (alternative to path)
                - filename: Override filename (auto-derived from path if omitted)
                - mime_type: MIME type override (optional)
        smtp_config: Optional SMTP configuration override with:
            - host: SMTP server hostname
            - port: SMTP server port
            - secure: Use SSL/TLS
            - username: Auth username
            - password: Auth password
            - from_email: Sender email address

    Returns:
        Success message or error message
test_smtp_connectionB

Test SMTP connection.

    Args:
        smtp_config: Optional SMTP configuration override with:
            - host: SMTP server hostname
            - port: SMTP server port
            - secure: Use SSL/TLS
            - username: Auth username
            - password: Auth password
            - from_email: Sender email address
            Falls back to environment variables if not provided.

    Returns:
        Connection test result or error message
test_imap_connectionA

Test IMAP connection and authentication without reading messages.

read_repliesA

Read recent reply emails from IMAP.

    Messages are read with BODY.PEEK and remain unread by default. Use
    ``from_address`` or ``subject_contains`` to narrow the result.
check_approval_statusB

Find an approval reply and classify it as approved, rejected, or pending.

wait_for_approvalB

Poll IMAP until an approval is approved, rejected, or times out.

send_progress_updateB

Send a standardized work-progress notification.

    The recipient defaults to ``notification.to`` in config.json. Use
    ``to`` only when a one-off recipient override is needed.
request_human_approvalB

Email a human approval request with a traceable approval ID.

    The recipient defaults to ``notification.to`` in config.json. The
    email asks the recipient to reply with “批准” or “拒绝”.

Prompts

Interactive templates invoked by user choice

NameDescription
compose_emailGenerate an email draft from intent, recipient name, and tone. Args: intent: What the email should communicate recipient_name: Name of the recipient tone: Desired tone (professional, casual, formal)
compose_replyGenerate a reply to an existing email. Args: original_email: The email being replied to intent: What the reply should communicate tone: Desired tone (professional, casual, formal)
compose_followupGenerate a follow-up email when no response has been received. Args: original_context: Context of the original message days_since: How long since the original was sent tone: Desired tone (professional, casual, formal)

Resources

Contextual data attached and managed by the client

NameDescription
config_statusCurrent SMTP configuration status (never exposes passwords).
providersList of supported email providers with configuration details.
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored across 9 tools

Disambiguation3/5

There is meaningful overlap between send_simple_email and send_custom_email, both centered on sending mail, and between read_replies, check_approval_status, and wait_for_approval, all of which interact with incoming IMAP replies. The descriptions help separate them, but an agent could still mis-select when trying to perform a generic send or read action.

Naming Consistency4/5

Most tool names follow a clear verb_noun snake_case pattern, such as test_imap_connection, send_custom_email, and check_approval_status. Minor deviations like wait_for_approval and the generic read_replies keep it from being perfectly uniform, but the naming is still predictable and readable.

Tool Count5/5

With 9 tools, the set is well-scoped for a Mail Notification MCP covering connection testing, email sending, reply reading, and approval handling. Each tool contributes to the server's core purpose without obvious bloat.

Completeness4/5

The approval workflow is well covered: send a request, read/classify the reply, and wait for a result. Generic mailbox operations like listing folders or fetching arbitrary messages are absent, but those are not central to the stated notification and approval purpose.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources