🏢 Microsoft Teams Integration

• Teams Management

  • List user's joined teams
  • Access team details and metadata

• Channel Operations

  • List channels within teams
  • Retrieve channel messages and replies
  • Send messages to team channels
  • Reply to existing channel threads
  • Edit and soft delete channel messages and replies
  • Support for message importance levels (normal, high, urgent)
  • Support for inline image attachments via URL or base64 data

• Team Members

  • List team members and their roles
  • Access member information
  • Search users for @mentions

💬 Chat & Messaging

• 1:1 and Group Chats
  • List user's chats
  • Create new 1:1 or group conversations
  • Retrieve chat message history with filtering, ordering, and pagination
  • Fetch all available messages via @odata.nextLink pagination
  • Send messages to existing chats
  • Edit previously sent chat messages
  • Soft delete chat messages

✏️ Message Management

• Edit & Delete
  • Update (edit) sent messages in chats and channels
  • Soft delete messages in chats and channels (marks as deleted without permanent removal)
  • Only message senders can update/delete their own messages
  • Support for Markdown formatting, mentions, and importance levels on edits

📎 Media & Attachments

• Hosted Content

  • Download hosted content (images, files) from chat and channel messages
  • Access inline images and attachments shared in conversations
  • Optionally save hosted content directly to disk

• File Upload

  • Upload and send any file type (PDF, DOCX, XLSX, ZIP, images, etc.) to channels and chats
  • Large file support (>4 MB) via resumable upload sessions
  • Channel uploads go to SharePoint and chat uploads go to OneDrive
  • Optional message text, custom filename, formatting, and importance levels

🔍 Advanced Search & Discovery

• Message Search
  • Search across all Teams channels and chats using Microsoft Search API
  • Support for KQL (Keyword Query Language) syntax
  • Filter by sender, mentions, attachments, read state, and date ranges
  • Get recent messages with advanced filtering options
  • Find messages mentioning the current user

Rich Message Formatting Support

The following tools support rich message formatting in Teams channels and chats:

• send_channel_message
• send_chat_message
• reply_to_channel_message
• update_channel_message
• update_chat_message
• send_file_to_channel
• send_file_to_chat

Format Options

You can specify the format parameter to control the message formatting:

• text (default): Plain text
• markdown: Markdown formatting (bold, italic, lists, links, code, etc.) converted to sanitized HTML

When format is set to markdown, the message content is converted to HTML using a secure markdown parser and sanitized to remove potentially dangerous content before being sent to Teams.

If format is not specified, the message will be sent as plain text.

Example Usage

{
  "teamId": "...",
  "channelId": "...",
  "message": "**Bold text** and _italic text_\n\n- List item 1\n- List item 2\n\n[Link](https://example.com)",
  "format": "markdown",
  "importance": "high"
}

{
  "chatId": "...",
  "message": "Simple plain text message",
  "format": "text"
}

Security Features

• HTML Sanitization: All markdown content is converted to HTML and sanitized to remove potentially dangerous elements (scripts, event handlers, etc.)
• Allowed Tags: Only safe HTML tags are permitted (p, strong, em, a, ul, ol, li, h1-h6, code, pre, etc.)
• Safe Attributes: Only safe attributes are allowed
• XSS Prevention: Content is automatically sanitized to prevent cross-site scripting attacks

Supported Markdown Features

• Text formatting: Bold (**text**), italic (_text_), strikethrough (~~text~~)
• Links: [text](url)
• Lists: Bulleted (- item) and numbered (1. item)
• Code: Inline `code` and fenced code blocks
• Headings: # H1 through ###### H6
• Blockquotes: > quoted text
• Tables: GitHub-flavored markdown tables

LLM-Friendly Content Format

Messages retrieved from the Microsoft Graph API are returned as raw HTML containing Teams-specific tags. To make this content more consumable by AI assistants, the following tools support automatic HTML-to-Markdown conversion:

• get_chat_messages
• get_channel_messages
• get_channel_message_replies
• search_messages
• get_my_mentions

Content Format Options

Use the contentFormat parameter to control how message content is returned:

• markdown (default): Converts Teams HTML to clean Markdown, optimized for LLM consumption
• raw: Returns the original HTML from the Microsoft Graph API

What Gets Converted

| HTML Element | Markdown Output | | -------------------------------------- | --------------------------------------------------------- | | <at id="0">Name</at> (Teams mention) | @Name (multi-word names merged using mentions metadata) | | <strong>text</strong> | **text** | | <em>text</em> | *text* | | <code>text</code> | `text` | | <a href="url">text</a> | [text](url) | | <ul><li>item</li></ul> | - item | | <table>...</table> | GFM Markdown table | | <attachment id="..."> | {attachment:id} | | <systemEventMessage/> | (removed) | | <hr> | --- | |  , &, etc. | Decoded to plain characters |

Attachment Metadata

Messages that contain file attachments or inline images include an attachments array in the response with metadata for each attachment (id, name, contentType, contentUrl, thumbnailUrl). The inline {attachment:id} markers in the markdown content correlate with entries in this array, allowing consumers to identify and download attachments via download_message_hosted_content or download_chat_hosted_content.

Example Usage

{
  "chatId": "19:meeting_...",
  "limit": 10,
  "contentFormat": "markdown"
}

To get the original HTML:

{
  "chatId": "19:meeting_...",
  "limit": 10,
  "contentFormat": "raw"
}

📦 Installation

# Install dependencies
npm install

# Build the project
npm run build

# Set up authentication
npm run auth

🔧 Configuration

Prerequisites

• Node.js 18+
• Microsoft 365 account with appropriate permissions
• Microsoft Graph delegated permissions for the scopes below

Required Microsoft Graph Permissions

Full mode (default):

• User.Read - Read user profile
• User.ReadBasic.All - Read basic user info
• Team.ReadBasic.All - Read team information
• Channel.ReadBasic.All - Read channel information
• ChannelMessage.Read.All - Read channel messages
• ChannelMessage.Send - Send channel messages and replies
• ChannelMessage.ReadWrite - Edit and delete channel messages
• Chat.Read - Read chat messages (included via read-only scopes)
• Chat.ReadWrite - Create and manage chats, send/edit/delete chat messages (supersedes Chat.Read)
• TeamMember.Read.All - Read team members
• Files.ReadWrite.All - Required for file uploads to channels and chats

Read-only mode (TEAMS_MCP_READ_ONLY=true) — only these scopes are requested:

• User.Read
• User.ReadBasic.All
• Team.ReadBasic.All
• Channel.ReadBasic.All
• ChannelMessage.Read.All
• TeamMember.Read.All
• Chat.Read

Authentication Modes

Full access:

npx @floriscornel/teams-mcp@latest authenticate

**Read-only a