search_messages

Search across Microsoft Teams channels and chats using advanced KQL filters for sender, mentions, attachments, and more. Retrieve relevant messages with customizable scope and result limits.

Instructions

Search for messages across all Microsoft Teams channels and chats using Microsoft Search API. Supports advanced KQL syntax for filtering by sender, mentions, attachments, and more.

Input Schema

Name	Required	Description	Default
`enableTopResults`	No	Enable relevance-based ranking
`limit`	No	Number of results to return
`query`	Yes	Search query. Supports KQL syntax like 'from:user mentions:userId hasAttachment:true'
`scope`	No	Scope of search	all

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "enableTopResults": {
      "default": true,
      "description": "Enable relevance-based ranking",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "description": "Number of results to return",
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "query": {
      "description": "Search query. Supports KQL syntax like 'from:user mentions:userId hasAttachment:true'",
      "type": "string"
    },
    "scope": {
      "default": "all",
      "description": "Scope of search",
      "enum": [
        "all",
        "channels",
        "chats"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Teams MCP

search_messages

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Teams MCP

Related Tools

MCP directory API