Teams Call History
teams_call_historyLists the Microsoft Teams calls and meetings that ended in the account's 50 most recent chats, newest first, from Microsoft 365: call type (call, meeting or screenShare), participants, start and end times and duration. Calls outside a chat (phone calls, calendar meetings without a chat) are not listed, and Microsoft does not say who started a call or whether it was answered: direction and answered are always empty. Optional since/until (YYYY-MM-DD) narrow the range. Looks at the 50 most recent chats and, in each, at its newest 50 messages that are not deleted (reading at most 20 pages of 50). 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).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max calls to return (default 50), newest first | |
| since | No | Only calls on/after this date, YYYY-MM-DD (optional) | |
| until | No | Only calls on/before this date, YYYY-MM-DD (optional) | |
| account | No | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| calls | No | ||
| count | No | ||
| error | No | ||
| account | No | The email (UPN) of the Microsoft 365 account this call used. | |
| truncated | No | Present and true only when the read was cut before it had everything it was asked for. |