Search Teams messages
teams_search_messagesSearch across Microsoft Teams chat and channel messages using full-text search. Returns matching messages with snippets and direct links for access.
Instructions
Search across the user's Teams chat and channel messages using the Microsoft Search API. Returns matching messages with a snippet and a deep link.
Note: relevance-ranked full-text search; exact phrasing and recency affect hits.
Args:
query (string): the search text (e.g. 'Plaid key', 'HIPAA BAA')
limit (number, 1-50): max hits (default 20)
response_format ('markdown' | 'json'): output format (default markdown)
Returns: JSON { total, count, moreResultsAvailable, hits: [{ id, from, createdDateTime, snippet, webUrl }] }.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "teams_search_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of items to return (1-50) | |
| query | Yes | Search text | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |