ids
Return the message ids matching a query.
How to use it
Project documentation lists ids for the Your Mail MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Your Mail MCP
claude mcp add your-mail -- docker exec -i your-mail-mcp your-mail-mcp stdioOther tools in Your Mail MCP (10)
One attachment or MIME part of a message, by part number from show. Images inline, text (JSON and XML included) as a marked block, other binaries as a signed download link.
Count the messages matching a query.
Return the maildir file paths matching a query.
List accounts, their folders, index tags, and each account's last sync and last error.
Sync every folder of one account or all accounts now, then reindex. Waits up to 20 seconds; if the pass is still running it says so.
Search mail. Returns thread summaries as JSON.
Show one message: headers and decoded body, as JSON.
Sync health per account: first-sync completion, last sync, messages indexed, errors and backoff.
Return the plain-text body of one message, converting HTML.
Show the whole thread containing a message. Excludes junk/trash replies by default; set includeexcluded to include them.