Outlook list emails

outlook__list_emails

Access

Requires a project integration connection for outlook.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
folderIdstringYesMail folder ID or well-known folder name
$topnumberNoMaximum messages to return
$skipnumberNoMessages to skip; use the $skip value from the previous page's @odata.nextLink
$selectstringNoComma-separated message fields to return
$orderbystringNoSort expression
$filterstringNoOData filter expression

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "outlook__list_emails",
    "arguments": {
      "folderId": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the outlook integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "folderId": {
      "type": "string",
      "description": "Mail folder ID or well-known folder name"
    },
    "$top": {
      "type": "number",
      "description": "Maximum messages to return"
    },
    "$skip": {
      "type": "number",
      "description": "Messages to skip; use the $skip value from the previous page's @odata.nextLink"
    },
    "$select": {
      "type": "string",
      "description": "Comma-separated message fields to return"
    },
    "$orderby": {
      "type": "string",
      "description": "Sort expression"
    },
    "$filter": {
      "type": "string",
      "description": "OData filter expression"
    }
  },
  "required": [
    "folderId"
  ],
  "description": "Arguments for the outlook__list_emails tool."
}