get_chat_messages

Retrieve chat messages by specifying a chat ID, with options to filter by user, time range, and sort order. Access message content, sender details, and timestamps for analysis or integration.

Instructions

Retrieve recent messages from a specific chat conversation. Returns message content, sender information, and timestamps.

Input Schema

Name	Required	Description	Default
`chatId`	Yes	Chat ID (e.g. 19:meeting_Njhi..j@thread.v2
`descending`	No	Sort in descending order (newest first)
`fromUser`	No	Filter messages from specific user ID
`limit`	No	Number of messages to retrieve
`orderBy`	No	Sort order	createdDateTime
`since`	No	Get messages since this ISO datetime
`until`	No	Get messages until this ISO datetime

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "chatId": {
      "description": "Chat ID (e.g. 19:meeting_Njhi..j@thread.v2",
      "type": "string"
    },
    "descending": {
      "default": true,
      "description": "Sort in descending order (newest first)",
      "type": "boolean"
    },
    "fromUser": {
      "description": "Filter messages from specific user ID",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Number of messages to retrieve",
      "maximum": 50,
      "minimum": 1,
      "type": "number"
    },
    "orderBy": {
      "default": "createdDateTime",
      "description": "Sort order",
      "enum": [
        "createdDateTime",
        "lastModifiedDateTime"
      ],
      "type": "string"
    },
    "since": {
      "description": "Get messages since this ISO datetime",
      "type": "string"
    },
    "until": {
      "description": "Get messages until this ISO datetime",
      "type": "string"
    }
  },
  "required": [
    "chatId"
  ],
  "type": "object"
}

Teams MCP

get_chat_messages

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Teams MCP

Related Tools

MCP directory API