get_recent_messages

Retrieve recent Microsoft Teams messages with filtering by time, users, mentions, attachments, importance, and keywords. Includes options to search channels or chats and specify teams.

Instructions

Get recent messages from across Teams with advanced filtering options. Can filter by time range, scope (channels vs chats), teams, channels, and users.

Input Schema

Name	Required	Description
`fromUser`	No	Filter messages from this user ID
`hasAttachments`	No	Filter messages with attachments
`hours`	No	Get messages from the last N hours (max 168 = 1 week)
`importance`	No	Filter by message importance
`includeChannels`	No	Include channel messages
`includeChats`	No	Include chat messages
`keywords`	No	Keywords to search for in message content
`limit`	No	Maximum number of messages to return
`mentionsUser`	No	Filter messages that mention this user ID
`teamIds`	No	Specific team IDs to search in

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "fromUser": {
      "description": "Filter messages from this user ID",
      "type": "string"
    },
    "hasAttachments": {
      "description": "Filter messages with attachments",
      "type": "boolean"
    },
    "hours": {
      "default": 24,
      "description": "Get messages from the last N hours (max 168 = 1 week)",
      "maximum": 168,
      "minimum": 1,
      "type": "number"
    },
    "importance": {
      "description": "Filter by message importance",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "type": "string"
    },
    "includeChannels": {
      "default": true,
      "description": "Include channel messages",
      "type": "boolean"
    },
    "includeChats": {
      "default": true,
      "description": "Include chat messages",
      "type": "boolean"
    },
    "keywords": {
      "description": "Keywords to search for in message content",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "Maximum number of messages to return",
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "mentionsUser": {
      "description": "Filter messages that mention this user ID",
      "type": "string"
    },
    "teamIds": {
      "description": "Specific team IDs to search in",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Teams MCP

get_recent_messages

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Teams MCP

Related Tools

MCP directory API