List all Microsoft Teams you are a member of.

Returns team id, name, and description for each team. Use a team_id with list_channels to see its channels.

List channels in a Microsoft Teams team.

Use list_teams first to get the team_id. Returns channel id, name, description, and membership type.

List TEAM-level tags of a team (id, name, member count).

Requires the TeamworkTag.Read delegated permission. These ids work as mention tag_ids in STANDARD channels. Shared channels have their own channel-scoped tags that Graph does not expose via any API - a team-level id posted there renders a phantom tag (no name, 0 members). For shared channels, reuse the tag id from the "mentions" entities of an existing message where a human @mentioned the tag.

List recent chats with participant names.

Does NOT include channel conversations - use list_teams + list_channels for those. Returns chat id, topic, type, and member names.

List recent top-level messages in a Teams channel.

Use list_teams -> list_channels to get team_id and channel_id. Replies are not included - read a thread with list_thread_replies. Returns up to limit (1-200) messages, the threads with the latest activity first (a new reply moves its thread up); there is no cursor for older ones. Each message has id, sender, timestamp and plain-text content, plus attachments, hostedContents (inline image ids for download_attachment) and mention entities when present. System messages are excluded.

List replies in a channel message thread.

Use list_channel_messages to get the parent message_id (a top-level message). Returns the parent message followed by up to limit (1-200) replies, newest first. In a longer thread the oldest replies, the ones right after the parent, are left out and nothing marks the cut. System messages are excluded.

List messages in a chat, newest first, a page at a time.

Use list_chats to get the chat_id. Returns {"messages": [...], "next_before": ...} with up to limit (1-200) messages created after after and before before: ISO 8601 timestamps, both exclusive and optional; one without an offset is read as UTC. For the next older page call again with before=next_before and the same after; next_before is null when no older messages are left in that range. Pages come newest first, so after alone returns the newest messages of the chat, not the ones right after that time. Each message has id, sender, createdDateTime and plain-text content, plus attachments, hostedContents (inline image ids for download_attachment) and mention entities when present. System messages are left out, so a page can hold fewer than limit messages.

Get one chat or channel message by its Teams link or by ids.

link: a message link copied from Teams, shaped like https://teams.microsoft.com/l/message//?... Without a link, pass message_id with chat_id, or with team_id + channel_id (plus parent_message_id, the thread root id, for a reply in a channel thread). Returns where the message lives (chat_id, or team_id + channel_id and, for a reply, parent_message_id) and the message with id, sender, createdDateTime and content. To see what led up to a chat message, call list_chat_messages with before=. Pages come newest first, so for what followed pass after= together with a before a little later (an hour on, for example); after alone returns the newest messages of the chat.

Send a message to a Teams channel.

Use list_teams -> list_channels to get team_id and channel_id. For replies to existing messages, use reply_to_channel_message instead.

content is plain text: newlines are kept and URLs become links; Markdown and HTML show literally. Each mention's "@" must appear in content exactly as given in name, or that mention is dropped without an error.

mentions: optional JSON array of users or team tags to @mention. Format: [{"user_id": "...", "name": "Display Name"} | {"tag_id": "...", "name": "TagName"}] Get tag_id from list_team_tags (tags work only in channel messages). Use @DisplayName in content where the mention should appear. Get user_id from list_team_members, list_channel_members, or get_user.

Send a message to a Teams chat.

Use list_chats to get the chat_id. reply_to: optional message ID to reply to (shows as a quoted reply). Use list_chat_messages to get the message_id.

content is plain text: newlines are kept and URLs become links; Markdown and HTML show literally. Each mention's "@" must appear in content exactly as given in name, or that mention is dropped without an error.

mentions: optional JSON array of users to @mention: [{"user_id": "...", "name": "Display Name"}]. Team tags cannot be mentioned in chats. Get user_id from list_chat_members or get_user. Use @DisplayName in content where the mention should appear.

Reply to a message in a Teams channel thread.

Use list_channel_messages to get the message_id to reply to. For new top-level messages, use send_channel_message instead.

content is plain text: newlines are kept and URLs become links; Markdown and HTML show literally. Each mention's "@" must appear in content exactly as given in name, or that mention is dropped without an error.

mentions: optional JSON array of users or team tags to @mention. Format: [{"user_id": "...", "name": "Display Name"} | {"tag_id": "...", "name": "TagName"}] Get tag_id from list_team_tags (tags work only in channel messages). Use @DisplayName in content where the mention should appear.

Send a message in the 1:1 chat with a user, creating the chat if needed.

If a 1:1 chat with this user already exists, Graph returns it, so there is no need to look it up with list_chats first. Returns chat_id and the sent message. user_email: the user's sign-in address (userPrincipalName) or user id from get_user; a mail alias that differs from the sign-in address may not resolve.

List members of a Microsoft Teams team.

Returns member id, display name, email, and roles (owner/member). Use list_teams to get the team_id.

List members of a specific channel.

Returns member id, display name, email, and roles. Use list_channels to get the channel_id.

List members of a chat.

Returns member id, display name, email, and roles. Use list_chats to get the chat_id.

Soft-delete a message you sent.

For channel messages: provide team_id + channel_id + message_id. For chat messages: provide chat_id + message_id. Works on top-level channel messages and on chat messages; channel thread replies are not supported (Graph addresses them under their parent message). Other members then see "This message has been deleted"; this server has no undo tool.

Edit a message you sent.

For channel messages: provide team_id + channel_id + message_id. For chat messages: provide chat_id + message_id. Works on top-level channel messages and on chat messages; channel thread replies are not supported (Graph addresses them under their parent message). Replaces the whole body with plain-text content; @mentions cannot be added on edit and existing ones become plain text. Only available in Global cloud (not GCC/DOD).

React to a message with an emoji.

For channel messages: provide team_id + channel_id + message_id. For chat messages: provide chat_id + message_id. Works on top-level channel messages and on chat messages; channel thread replies are not supported (Graph addresses them under their parent message). Common reactions: like, angry, sad, laugh, heart, surprised. Custom reactions: any unicode emoji.

Remove a reaction from a message.

For channel messages: provide team_id + channel_id + message_id. For chat messages: provide chat_id + message_id. Works on top-level channel messages and on chat messages; channel thread replies are not supported (Graph addresses them under their parent message).

Create a new group chat with you and at least two other users.

For one other person use create_chat. Every call creates a new chat; Graph does not reuse an existing group chat with the same members. member_emails: comma-separated sign-in addresses of the other members (e.g. "a@org.com, b@org.com"). topic: optional chat topic/name. message: optional first message to send.

Pin a message in a chat.

Only works in chats, not channels. Use list_chat_messages to get the message_id.

Unpin a message from a chat.

Use list_pinned_messages to get the pinned_message_info_id (NOT the message_id).

List pinned messages in a chat.

Returns pinned message info including the message content. Use list_chats to get the chat_id.

Mark a chat as read for the current user.

Use list_chats to get the chat_id.

Mark a chat as unread for the current user.

last_message_read_date_time: ISO 8601 timestamp of the last message that should be considered as read (e.g. "2026-03-26T10:00:00Z"). Messages after this timestamp will appear as unread.

Get the presence/availability status of a user.

Returns availability (Available, Busy, DoNotDisturb, Away, Offline, etc.) and activity (InACall, InAMeeting, Presenting, etc.). Get the user_id from list_team_members, list_chat_members, or get_user.

Search Teams messages in all chats and channels the signed-in user can see.

Matches message content, including attachments (Microsoft Search). Returns up to size hits, newest first, with no further pages. Each hit has a snippet (summary, not the full body), sender name and email, timestamp, chatId or channelIdentity, and a webLink. Message ids are not returned - to reply to, react to or delete a hit, find it with list_chat_messages or list_channel_messages.

Find users whose display name or email address starts with query.

Prefix match only (Graph startsWith on displayName or mail): a surname or a fragment from the middle of a name finds nothing. Returns up to limit users with id, display name, email (mail, else userPrincipalName) and job title. The id is what get_user_presence and mention user_id take; create_chat takes the email.

Download an inline image (hosted content) from a message.

For channel messages: provide team_id + channel_id + message_id. For content inside a channel REPLY: additionally pass parent_message_id (the thread root id) - Graph serves reply content only under /messages/{parent}/replies/{reply}. For chat messages: provide chat_id + message_id. hosted_content_id: from the hostedContents array in message data. Returns the local file path to the downloaded image. File attachments listed under attachments (SharePoint/OneDrive files) cannot be downloaded with this tool. The image is written to the system temp directory on the machine running this server and is not deleted afterwards.