outlook_list_messages

Pack: outlook-mail · Endpoint: https://gateway.pipeworx.io/outlook-mail/mcp

List email messages from an Outlook / Microsoft 365 mailbox folder (default: inbox). Returns compact message summaries (subject, sender, received time, preview, read status, attachment flag). Supports keyword search and unread-only filtering. Use to browse a user’s Outlook email.

Parameters

NameTypeRequiredDescription
folderstringnoMail folder to read from (default: “inbox”). Use a well-known name like “inbox”, “sentitems”, “drafts”, “deleteditems”, or a folder ID from outlook_list_folders.
topnumbernoMaximum number of messages to return (default 25, max 100).
searchstringnoOptional free-text keyword search across the messages (subject, body, sender, etc.).
unread_onlybooleannoIf true, return only unread messages.

Example call

curl -X POST https://gateway.pipeworx.io/outlook-mail/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"outlook_list_messages","arguments":{}}}'

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "outlook-mail": {
      "url": "https://gateway.pipeworx.io/outlook-mail/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build June 3, 2026