Teams MCP

Check the authentication status of the Microsoft Graph connection. Returns whether the user is authenticated and shows their basic profile information.

Start Microsoft Teams authentication via device code flow. Returns a URL and code for the user to complete sign-in in their browser. Use this when auth_status shows not authenticated.

List all recent chats (1:1 conversations and group chats) that the current user participates in. Returns chat topics, types, and participant information.

Retrieve recent messages from a specific chat conversation. Returns message content, sender information, and timestamps.

Send a message to a specific chat conversation. Supports text and markdown formatting, mentions, and importance levels.

Create a new chat conversation. Can be a 1:1 chat (with one other user) or a group chat (with multiple users). Group chats can optionally have a topic.

Update (edit) a chat message that was previously sent. Only the message sender can update their own messages. Supports updating content with text or Markdown formatting, mentions, and importance levels.

Soft delete a chat message that was previously sent. Only the message sender can delete their own messages. The message will be marked as deleted but can still be seen as '[This message has been deleted]'.

Download files and images from a chat message. Handles both inline images (hosted content) and file attachments (OneDrive/SharePoint references). Use get_chat_messages first to see available attachments.

Get the manager of a user. Returns the user's direct manager with their profile information. If no userId is provided, returns the current user's manager.

Get the direct reports of a user. Returns a list of users who report directly to the specified user. If no userId is provided, returns the current user's direct reports.

Get the full chain of managers for a user, from their direct manager up to the top of the organization. Useful for understanding the reporting hierarchy.

Find recent messages where the current user was @mentioned across all Teams channels and chats.

List all Microsoft Teams that the current user is a member of. Returns team names, descriptions, and IDs.

List all channels in a specific Microsoft Team. Returns channel names, descriptions, types, and IDs for the specified team.

Retrieve recent messages from a specific channel in a Microsoft Team. Returns message content, sender information, and timestamps.

Send a message to a specific channel in a Microsoft Team. Supports text and markdown formatting, mentions, and importance levels.

Get all replies to a specific message in a channel. Returns reply content, sender information, and timestamps.

Reply to a specific message in a channel. Supports text and markdown formatting, mentions, and importance levels.

List all members of a specific Microsoft Team. Returns member names, email addresses, roles, and IDs.

Search for users to mention in messages. Returns users with their display names, email addresses, and mention IDs.

Download hosted content (such as images) from a Teams channel message. Returns the content as base64 encoded data along with metadata. Use this to retrieve images or other inline content embedded in messages.

Soft delete a message in a channel. Only the message sender can delete their own messages. The message will be marked as deleted.

Update (edit) a message in a channel that was previously sent. Only the message sender can update their own messages.

Get the current authenticated user's profile information including display name, email, job title, and department.

Search for users in the organization by name or email address. Returns matching users with their basic profile information.

Get detailed information about a specific user by their ID or email address. Returns profile information including name, email, job title, and department.