List Mail Folder Messages

Retrieves filtered and sorted Microsoft Outlook mail folder messages via Graph API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill list-mail-folder-messages
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: List Mail Folder Messages
Source: https://github.com/naftiko/microsoft-outlook-sandbox/tree/main/skills/list-mail-folder-messages
Command: npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill list-mail-folder-messages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows users to easily view and manage messages within specific folders in their Microsoft Outlook account, streamlining email organization and retrieval.

Core Features & Use Cases

  • List Messages: Retrieve a list of all messages within a specified mail folder.
  • Filtering and Sorting: Apply query parameters to filter, sort, and select specific message properties for targeted results.
  • Pagination: Control the number of messages returned using $top and $skip parameters.
  • Use Case: Quickly find all unread emails in your "Project Alpha" folder by listing messages and filtering by isRead eq false.

Quick Start

List the 10 most recent messages in the 'inbox' folder, showing only the subject and sender.

Frequently Asked Questions about List Mail Folder Messages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list messages from a specific Outlook mail folder?

The Skill retrieves messages from a specified Microsoft Outlook mail folder by supporting filtering, sorting, and selecting specific message properties. It requires a valid OAuth access token with Mail.Read or Mail.ReadWrite scope to authenticate and access the mailbox.

What's the best way to filter unread emails in an Outlook folder?

The best way to filter unread emails in an Outlook folder is by applying the `isRead eq false` query parameter to your message list request. This filters out read messages and returns only the unread items from the specified folder.

Do I need an OAuth token to read Outlook email messages?

Yes, reading Outlook email messages requires a valid OAuth access token with either the Mail.Read or Mail.ReadWrite scope. This authentication is necessary to authorize the application to retrieve messages from the specified mail folder.

Can I limit the number of messages returned when listing Outlook emails?

Yes, you can limit the number of returned messages using the `$top` parameter. To navigate through larger result sets, combine `$top` with the `$skip` parameter to implement pagination and retrieve messages in controlled batches.

How does sorting work when retrieving messages from a mail folder?

Sorting works by applying query parameters to order the retrieved messages based on specific message properties. This allows you to organize the retrieved Outlook communications according to your targeted search preferences and workflow needs.