list-messages
List messages in a mailbox.
How to use it
list-messages is exposed by the Apple Mail MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the list-messages tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Apple Mail MCP
$
claude mcp add apple-mail -s user -- npx -y apple-mail-mcpOther tools in Apple Mail MCP (23)
account
string
attachments
(string \
bcc
string[]
body
string
cc
string[]
dateFrom
string
dateTo
string
from
string
get-message
Get the full content of a message.
id
string
isFlagged
boolean
isRead
boolean
limit
number
mailbox
string
offset
number
preferHtml
boolean
query
string
search-messages
Search for messages matching criteria. Searches all accounts by default.
send-email
Send a new email immediately.
subject
string
to
string[]
transport
"applescript" \
unreadOnly
boolean