Skip to main content
Glama
Guascoign

Mail Notification MCP

by Guascoign

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.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Guascoign/Mail_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server