Skip to content

teams chat list

Lists all Microsoft Teams chat conversations for the current user.


m365 teams chat list [options]


-t, --type [chatType]
The chat type to optionally filter chat conversations by type. The value can be oneOnOne, group or meeting.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
Runs command with verbose logging
Runs command with debug logging


List all the Microsoft Teams chat conversations of the current user.

m365 teams chat list

List only the one on one Microsoft Teams chat conversations.

m365 teams chat list --type oneOnOne


    "id": "19:2da4c29f6d7041eca70b638b43d45437@thread.v2",
    "topic": null,
    "createdDateTime": "2022-11-05T13:06:25.218Z",
    "lastUpdatedDateTime": "2022-11-05T13:06:25.218Z",
    "chatType": "oneOnOne",
    "webUrl": "",
    "tenantId": "446355e4-e7e3-43d5-82f8-d7ad8272d55b",
    "onlineMeetingInfo": null,
    "viewpoint": {
      "isHidden": false,
      "lastMessageReadDateTime": "2022-11-05T13:06:30.582Z"
id                                             topic  chatType
---------------------------------------------  -----  --------
19:2da4c29f6d7041eca70b638b43d45437@thread.v2  null   oneOnOne