find_unreplied_messages
sender (required), mailboxes (optional, defaults to INBOX), since, before, and limit. Uses In-Reply-To and References; messages without Message-ID are returned as unknownMessages instead of being guessed from their subject.
How to use it
find_unreplied_messages is exposed by the MCP Mail Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the find_unreplied_messages tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
FULL MCP MAIL SERVER LISTINGOther tools in MCP Mail Server (11)
Connects to IMAP when needed, actively verifies SMTP, and returns structured status
subject (string), recipient (string, optional narrowing match), since (string, optional), text (string, optional), html (string, optional), signature (object, optional), replyToAll (boolean, default: true), and includeOriginal (boolean, default: true). Finds the newest exact normalized subject in th
mailbox (string), uid (number), uidValidity (number, optional). Verifies the UID exists and permanently deletes only that UID. If STORE or UID EXPUNGE reports an error, the tool verifies the source UID and rolls back \\Deleted when possible. A transport failure that cannot be confirmed returns a str
mailbox (string), uid (number), uidValidity (number, optional), markSeen (boolean, optional)
mailbox (string), uids (array), uidValidity (number, optional), markSeen (boolean, optional). The call fails before fetching bodies if any requested UID is missing, and fails explicitly if the combined returned bodies exceed MAILMAXRESPONSECHARACTERS.
No parameters required
mailbox (string), uid (number), targetMailbox (string), uidValidity (number, optional). The source UID and target mailbox must already exist. Fails safely unless the server supports MOVE or UIDPLUS. When the server returns a destination UID, the result also refreshes destinationUidValidity so the ta
mailbox (string), originalUid (number), uidValidity (number, optional), text (string, optional), html (string, optional), signature (object, optional: text and/or html), replyToAll (boolean, default: false), includeOriginal (boolean, default: true). At least one of text or html is required.
mailbox (string), uid (number), uidValidity (number, optional), savePath (string, absolute path), attachmentIndex (number, optional, 0-based), returnBase64 (boolean, optional, default: false). When saving multiple attachments, a later write failure returns isError: true, partial, savedFiles, and fai
Combines mailboxes, from, to, subject, body, IMAP keywords, unread, inclusive since, exclusive before, limit, and includeBody. Omit mailboxes to search INBOX and the detected sent mailbox. Date/time searches widen the IMAP calendar-day query by two days on each side, then apply the exact instant loc
to (string), subject (string), text (string, optional), html (string, optional), signature (object, optional: text and/or html), cc (string, optional), bcc (string, optional), attachments (string[], optional, absolute file paths). At least one of text or html is required.