mcp-for-apple-mail
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| {} | No |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_mailboxesA | Listet alle Apple-Mail-Konten und Mailboxen als ":"-Zeilen. Damit findet man die exakten Namen für den mailboxes-Parameter der anderen Tools. |
| search_messagesA | Sucht Nachrichten in einem Zeitfenster und listet Treffer samt Anhangnamen (ATT{...}) und Flaggen-Markierung (⚑). So sieht man sofort, was als PDF vorliegt. Filtert nach Absender-Stichworten und/oder nur geflaggten Nachrichten; ohne einen der beiden Filter käme alles zurück. Dedupliziert über die message id. |
| save_attachmentA | Speichert den ersten passenden PDF-Anhang einer über den Betreff gefundenen Nachricht. Ein Anhang passt nur, wenn sein Name attKey enthält und auf .pdf endet (sortiert AGB, Werbe-PDFs, XML und Bilder aus). Der Zielordner wird angelegt. |
| get_message_bodyA | Liefert den Klartext-Inhalt der ersten passenden Nachricht samt Kopf (From, Subject, Date). Für Belege, die nur im Mailtext stehen und kein PDF anhängen. Mindestens subjKey oder senderKey angeben. |
| flag_messageA | Setzt oder entfernt die Fahne an GENAU EINER Nachricht, optional mit Farbe (flagIndex 0-6: rot, orange, gelb, grün, blau, lila, grau). Passt der Schlüssel auf mehrere Nachrichten, wird nichts geändert und die Mehrdeutigkeit gemeldet (Schlüssel verengen). Praktisch, um eine verarbeitete Rechnung zu markieren. Mindestens subjKey oder senderKey angeben. Verändert die Nachricht. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Most tools are clearly distinct in purpose: save_attachment extracts files, get_message_body reads text, flag_message toggles flags, list_mailboxes enumerates folders, search_messages queries. The main potential confusion is between get_message_body and save_attachment since both target 'the first matching message' and both depend on subjKey/senderKey, but their outputs differ enough that overlap is limited.
All names follow a verb_noun snake_case convention (save_attachment, get_message_body, flag_message, list_mailboxes, search_messages), which is fairly consistent. The verbs vary in tone (save, get, flag, list, search) without a strong single pattern, but overall the naming is readable and predictable.
Five tools is on the smaller side but appropriate for a narrowly-scoped mail-processing server aimed at handling invoices/attachments. Each tool serves a distinct, useful purpose and the count feels justified for the stated domain rather than overly thin.
The tools cover the core workflow of finding messages, reading bodies, extracting attachments, and flagging, which is reasonable. However, there are notable gaps: no way to move messages between mailboxes, delete messages, search by content within attachments beyond the first PDF, or handle multiple-attachment messages. The set is oriented around a narrow 'process invoices/receipts' workflow rather than general mail management.