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). A chat the account cannot read (403 or 404) is skipped and counted in skipped_chats. 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). When no Microsoft 365 account is connected at all, it reads the Teams app's local cache on this Mac instead (needs Full Disk Access, can be hours or days behind); the answer's source says which one answered (graph or local_cache).
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 | ||
| source | No | Which source answered: graph (Microsoft 365) or local_cache (the Teams app's cache on this Mac, used only when no Microsoft 365 account is connected). | |
| account | No | The email (UPN) of the Microsoft 365 account this call used. | |
| fix_tool | No | ||
| truncated | No | Present and true only when the read was cut before it had everything it was asked for. | |
| skipped_chats | No | How many chats were skipped because the account cannot read them (403 or 404). Present only when above 0. |