Get Mail Search Folder

Retrieve properties and relationships of a mail search folder by ID via the Microsoft Outlook Mail API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to programmatically access the properties and relationships of a specific mail search folder within Microsoft Outlook, enabling better organization and retrieval of targeted email collections.

Core Features & Use Cases

  • Detailed Folder Information: Retrieves essential details like display name, item counts, and filter queries for a given search folder.
  • Programmatic Access: Enables integration with other applications or scripts to manage and query mail folders.
  • Use Case: An application could use this Skill to display a list of all user-defined "Unread Priority Mail" search folders, showing their current item counts.

Quick Start

Use the Get Mail Search Folder skill to retrieve details for the search folder with ID 'AAMkAGI1SEARCH01=' within the parent mail folder 'AAMkAGI1AAAEJAAA='.

Frequently Asked Questions about Get Mail Search Folder

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

FAQPage Schema
How do I retrieve Microsoft Outlook mail search folder properties using an API?

To retrieve Microsoft Outlook mail search folder properties, use this Skill to query the Microsoft Graph Mail API by providing the required mailFolder-id and childFolder-id path parameters to access specific folder details and relationships.

What details can I get from an Outlook mail search folder via Microsoft Graph?

Retrieving an Outlook mail search folder via Microsoft Graph returns essential properties like the folder display name, item counts, and filter queries, enabling programmatic access to targeted email collections and organization.

Can I use Microsoft Graph API to get item counts for a specific Outlook search folder?

Yes, you can use the Microsoft Graph API to get item counts for a specific Outlook search folder by requesting the folder's properties using its unique mailFolder-id and childFolder-id parameters.

How to access a child mail search folder in Outlook programmatically?

To access a child mail search folder in Outlook programmatically, call the Microsoft Graph Mail API with the parent mailFolder-id and the specific childFolder-id to retrieve the targeted folder's data.

Do I need folder IDs to query Outlook search folders with Microsoft Graph?

Yes, querying Outlook search folders with Microsoft Graph requires precise identification using both the mailFolder-id and childFolder-id path parameters to successfully locate and retrieve the specific folder details.

Why does retrieving an Outlook mail search folder require two IDs?

Retrieving an Outlook mail search folder requires two IDs because search folders often exist as child folders within parent mail folders, making both mailFolder-id and childFolder-id necessary for precise identification in the API hierarchy.