teams_read_chat_messages
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
Reads the most recent messages of a Microsoft Teams chat (chat_id from teams_list_chats), oldest first, from Microsoft 365. Deleted messages are skipped; a system event (a member added, a call) shows as [kind]. Times are in this computer's time zone. Reads at most 20 pages of 50 messages, deleted ones included. 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).
Required inputs
chat_id— Chat ID from teams_list_chats
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.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
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"
},
"chat_id": {
"description": "Chat ID from teams_list_chats",
"type": "string"
},
"limit": {
"description": "Max items to return (default 50)",
"type": "integer"
}
},
"required": [
"chat_id"
],
"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.
{
"chat_id": "demo-chat-001"
}Windows
Purpose
Reads messages from a specific Teams chat conversation. Reads at most 20 pages of 50 messages, deleted ones included. When the read is cut (by that bound, or because the call ran out of time) the answer has truncated: true.
Required inputs
chat_id— Chat ID from teams_list_chats
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.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
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"
},
"chat_id": {
"description": "Chat ID from teams_list_chats",
"type": "string"
},
"limit": {
"description": "Maximum messages (default: 50)",
"type": "number"
}
},
"required": [
"chat_id"
],
"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.
{
"chat_id": "demo-chat-001"
}