List the Teams accounts (tenant/user contexts) in the local cache.

Each: key (use as the account filter elsewhere), tenant_id, user_id and a best-effort label inferred from org names in messages.

List chats/channels (id, title, type), optionally filtered by account.

Return up to limit most recent messages of a conversation (newest last).

Case-insensitive substring search across cached messages.

Optional days restricts to messages received in the last N days.

Messages received in the last days days, newest first — in ONE call.

Ideal for 'what did I get while I was away'. Filter by account (see list_accounts) to scope to one tenant/org.

@-mentions of you (someone @mentioned you), newest first, with content.

unread_only keeps only not-yet-read mentions; days restricts recency; account scopes to one tenant (see list_accounts). This is the only reliable read/unread signal in the local store.

Unread items needing attention = your UNREAD @-mentions.

⚠️ The local Teams cache has NO general read marker (per-message read state is not stored on disk), so true 'all unread' can't be derived. Unread @-mentions are the reliable signal. For 'everything that arrived while I was away', use recent_messages(days=...) instead (you read nothing while away → recent ≈ unread).

Who messaged you: recent activity grouped by conversation, newest first.

Per conversation: title, message count, distinct senders, last message + time. Great first call to get the lay of the land before drilling in.