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
| Name | Type | Required | Description |
|---|---|---|---|
folder | string | no | Mail folder to read from (default: “inbox”). Use a well-known name like “inbox”, “sentitems”, “drafts”, “deleteditems”, or a folder ID from outlook_list_folders. |
top | number | no | Maximum number of messages to return (default 25, max 100). |
search | string | no | Optional free-text keyword search across the messages (subject, body, sender, etc.). |
unread_only | boolean | no | If 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.