Receipt Sweep
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_email_providersA | List supported email providers and their setup instructions. Call this first to show the user which providers are supported and how to generate an App Password for their provider. |
| connect_emailA | Connect to an email inbox via IMAP. Args: provider: Provider name ('gmail', 'yahoo', 'outlook', 'icloud') or a raw IMAP hostname (e.g. 'imap.example.com'). email_address: The full email address to sign into. app_password: An App Password for the account (NOT the regular password). See list_email_providers() for how to create one. Returns a status message. The connection persists for subsequent tool calls. |
| disconnect_emailA | Disconnect from the current email inbox. |
| connection_statusA | Check whether an email connection is active, and report the server version. Sends a NOOP so a socket the mail server has silently closed is noticed (and re-opened) here rather than on the next search or read. |
| list_foldersA | List all folders/labels in the connected mailbox. Returns folder names that can be passed to search_emails and read_email. |
| search_emailsA | Search for emails in a folder. Args: folder: Mailbox folder to search (default 'INBOX'). Use list_folders() to see all available folders. Common: INBOX, Sent, Trash, [Gmail]/All Mail, Bulk (Yahoo spam), Archive. from_address: Filter by sender email address. subject_contains: Filter by text in the subject line. body_or_subject: Search for text in the subject OR body. since_date: Only emails on or after this date (YYYY-MM-DD). before_date: Only emails before this date (YYYY-MM-DD). limit: Max results to return (default 50, newest first). Returns a JSON list of {id, date, from, subject} for matching emails. Use read_email() with the id to get the full content. |
| read_emailA | Read the full content of a specific email. Args: message_id: The message ID from search_emails results. folder: The folder the message is in (must match the search). Returns the email's date, sender, subject, body text, and a list of any attachments (with filenames and sizes). The body is taken from whichever of the plain-text or HTML parts contains the order details. If has_pdf is true and the body has no amount, call read_pdf_attachment. |
| read_pdf_attachmentA | Extract the text of a PDF attachment, such as an emailed receipt. Use this when read_email lists a PDF attachment and the body only says something like "your receipt is attached". Args: message_id: The message ID from search_emails results. filename: The PDF's filename (from read_email's attachments list). folder: The folder the message is in. Returns the PDF's text, or an error message. |
| save_attachmentA | Download an email attachment and save it to disk. Args: message_id: The message ID from search_emails results. filename: The attachment filename (from read_email's attachments list). save_path: Local file path to save the attachment to. folder: The folder the message is in. Returns the path to the saved file, or an error message. |
| search_all_foldersA | Search across ALL folders in the mailbox (inbox, spam, trash, archive, custom folders). Same parameters as search_emails but runs the search in every folder. Returns results grouped by folder, plus any folders that could not be searched. Slower but thorough. |
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 10 tools
Most tools target clearly distinct operations (connect vs. search vs. read vs. attachment handling). The main overlap is search_emails vs. search_all_folders, and connect_email vs. connection_status, but the descriptions clearly differentiate scope and intent.
Nearly all tools use a consistent snake_case verb_noun pattern (connect_email, search_emails, read_email, save_attachment). The noun-only connection_status is a minor deviation but still readable and unambiguous.
Ten tools is well-scoped for an email/receipt-sweeping server, covering connection lifecycle, discovery, search, reading, and attachments without redundancy.
The surface covers the full read-side lifecycle: connect/disconnect/status, provider and folder discovery, single- and all-folder search, message reading, and PDF/attachment extraction. Missing write operations (delete, move, mark) are outside the stated receipt-extraction purpose.