Skip to content
All tools

teams_list_chats

Microsoft Teams · macOS · Windows

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Lists the Microsoft Teams chats of a Microsoft 365 account — direct messages, group chats and meeting chats — most recently active first, read from Microsoft 365. Each chat has its id (for teams_read_chat_messages), a title, the other participants, its type (oneOnOne, group or meeting) and its last message. participants names every other member; one whose name could not be read shows as "unnamed member" (or "unnamed member (external)"), never as nothing. participants_state says how far to trust it: resolved, unresolved (at least one unnamed), only_you (nobody else in the chat) or unknown (the member list could not be read: participant_count and has_external_members are then absent). Reads at most 20 pages of 50 chats. When the read is cut (by that bound, or because the call ran out of time) the answer has truncated: true. Needs a work or school Microsoft 365 account connected with connect_m365_account (personal Microsoft accounts have no Teams reads). When no Microsoft 365 account is connected at all, it reads the Teams app's local cache on this Mac instead (needs Full Disk Access, can be hours or days behind); the answer's source says which one answered (graph or local_cache).

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 5
}

Windows

Purpose

Lists your recent Microsoft Teams chat conversations via Microsoft Graph, using the connected Microsoft 365 account. Reads at most 20 pages of 50 chats. When the read is cut (by that bound, or because the call ran out of time) the answer has truncated: true. participants names every other member; one whose name could not be read shows as "unnamed member" (or "unnamed member (external)"), never as nothing. participants_state says how far to trust it: resolved, unresolved (at least one unnamed), only_you (nobody else in the chat) or unknown (the member list could not be read: participant_count and has_external_members are then absent).

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum chats to return (default: 50)",
      "type": "number"
    }
  },
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 5
}