Skip to main content
Glama
uth-mail-mcp

uth-mail-mcp

by fotispetrou

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
UTHMAIL_NAMENoThe display name to use in the From field of your messages.
UTHMAIL_ADDRESSNoYour full email address if it is not username@uth.gr.
UTHMAIL_PASSWORDNoYour UTH mail password. Can be used instead of storing credentials in the system keychain.
UTHMAIL_USERNAMENoYour UTH mail username without @uth.gr. Can be used instead of storing credentials in the system keychain.
UTHMAIL_IMAP_HOSTNoThe IMAP host for your department, for example mail.ece.uth.gr.mail.ds.uth.gr
UTHMAIL_DOWNLOAD_DIRNoDirectory where downloaded attachments are saved.~/Downloads/uth-mail

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Access to a University of Thessaly email account over IMAP and SMTP: search and read messages, download attachments, mark and move messages, write drafts and send them.

Messages are addressed by folder and uid; uids come from search_messages. Folders can be named as list_folders shows them or as inbox, sent, drafts, trash, junk. Dates are returned as written in the message and normalized in *_iso fields (local time, YYYY-MM-DD HH:MM).

Sending takes two steps: create_draft saves the message in Drafts and send_draft sends it. Only call send_draft after the user has seen that draft and clearly asked for it to be sent.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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

Tools

Functions exposed to the LLM to take actions

NameDescription
whoamiA

Check that the login works and see which account, servers and mailbox quota are in use.

list_foldersA

All mail folders with their message and unread counts. role marks the inbox, sent, drafts, trash, junk and archive folders.

search_messagesA

Find messages, newest first; with no filters, the latest ones.

query searches whole messages (headers and text) on the server. sender, to and subject match those headers, and to also covers Cc; Greek text there is matched without regard to case or accents, over the newest 3000 candidates. since and before are arrival dates (YYYY-MM-DD), before exclusive. Each result has uid, date, from, to, subject, read/flag state and whether it has attachments; use get_message for the text.

get_messageB

A whole message: headers, the text (HTML mail converted to plain text) and its attachments. Reading it does not mark it as read.

download_attachmentA

Save one attachment of a message; index is its number in get_message. Saves under ~/Downloads/uth-mail/ unless a destination directory is given, and returns the local file path.

mark_messagesB

Mark messages as read or unread (read) and/or flagged or not (flagged).

move_messagesA

Move messages to another folder. Moving to trash is how to delete them; they can be moved back from there.

create_draftA

Write a message and save it in Drafts. Nothing is sent.

To reply, give reply_to_uid (and reply_folder if the original is not in the inbox): recipient, 'Re:' subject, threading headers and the quoted original are filled in, and reply_all adds the other recipients as Cc. attachments are paths of local files. Returns the draft's uid for send_draft; the user can also open and edit the draft in webmail.

send_draftA

Send a draft from the Drafts folder and file a copy in Sent. This really sends email: call it only after showing the user that draft (recipients, subject and text) and getting a clear yes for it.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation5/5

Each tool maps to a distinct resource/action: listing folders, searching, fetching a message, downloading an attachment, toggling flags, moving, drafting, sending, and identity check. The only near-pair, create_draft vs send_draft, is explicitly separated by 'nothing is sent' versus the strong 'this really sends email' warning. Reply behavior is folded into create_draft rather than a competing tool, avoiding overlap.

Naming Consistency4/5

Eight of nine tools follow a clean verb_noun snake_case pattern (list_folders, search_messages, get_message, download_attachment, mark_messages, move_messages, create_draft, send_draft). whoami is the single deviation, though it is a well-understood convention rather than an inconsistency in style.

Tool Count5/5

Nine tools is well within the ideal 3-15 range and every tool earns its place: no redundant variants, no thin wrappers. The surface is scoped tightly to one mailbox workflow without padding.

Completeness4/5

Core lifecycle is covered: discover folders, search, read, fetch attachments, flag, move/delete via trash, compose drafts (including reply/reply-all), and send. Minor gaps remain, such as forwarding a message, permanently emptying trash, and folder management, but agents can work around these within the stated purpose.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues