What is Teams Mcp

teams-mcp is a Model Context Protocol (MCP) server designed for Microsoft Teams, facilitating easy integration with Microsoft Graph APIs for AI assistants to interact with Teams, users, and organizational data.

Use cases

Use cases for teams-mcp include managing team memberships, sending messages in channels, retrieving user information, and facilitating chat interactions within Microsoft Teams.

How to use

To use teams-mcp, add the provided JSON configuration to your application, specifying the command and arguments to run the MCP server using npx.

Key features

Key features include OAuth 2.0 authentication, user management capabilities, Microsoft Teams integration for team and channel operations, and chat and messaging functionalities.

Where to use

teams-mcp can be utilized in applications that require interaction with Microsoft Teams, such as AI assistants, productivity tools, and organizational communication platforms.

Teams MCP

A Model Context Protocol (MCP) server that provides seamless integration with Microsoft Graph APIs, enabling AI assistants to interact with Microsoft Teams, users, and organizational data.

📦 Installation

To use this MCP server in Cursor/Claude/VS Code, add the following configuration:

{
  "mcpServers": {
    "teams-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@floriscornel/teams-mcp@latest"
      ]
    }
  }
}

🚀 Features

🔐 Authentication

• OAuth 2.0 authentication flow with Microsoft Graph
• Secure token management and refresh
• Authentication status checking

👥 User Management

• Get current user information
• Search users by name or email
• Retrieve detailed user profiles
• Access organizational directory data

🏢 Microsoft Teams Integration

• Teams Management

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

• Channel Operations

  • List channels within teams
  • Retrieve channel messages
  • Send messages to team channels
  • Support for message importance levels (normal, high, urgent)

• Team Members

  • List team members and their roles
  • Access member information

💬 Chat & Messaging

• 1:1 and Group Chats
  • List user’s chats
  • Create new 1:1 or group conversations
  • Retrieve chat message history with filtering and pagination
  • Send messages to existing chats

🔍 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, importance, and date ranges
  • Get recent messages with advanced filtering options
  • Find messages mentioning specific users

Rich Message Formatting Support

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

• send_channel_message
• send_chat_message
• reply_to_channel_message

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"
}

{
  "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 (href, target, src, alt, title, width, height)
• 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](https://raw.githubusercontent.com/floriscornel/teams-mcp/master/url)
• Lists: Bulleted (- item) and numbered (1. item)
• Code: Inline `code` and blocks code
• Headings: # H1 through ###### H6
• Line breaks: Automatic conversion of newlines to <br> tags
• Blockquotes: > quoted text
• Tables: GitHub-flavored markdown tables

📦 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
• Azure App Registration with Microsoft Graph permissions

Required Microsoft Graph Permissions

• 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
• Chat.Read - Read chat messages
• Chat.ReadWrite - Create and manage chats
• Mail.Read - Required for Microsoft Search API
• Calendars.Read - Required for Microsoft Search API
• Files.Read.All - Required for Microsoft Search API
• Sites.Read.All - Required for Microsoft Search API

🛠️ Usage

Starting the Server

# Development mode with hot reload
npm run dev

# Production mode
npm run build && node dist/index.js

Available MCP Tools

Authentication

• authenticate - Initiate OAuth authentication flow
• logout - Clear authentication tokens
• get_current_user - Get authenticated user information

User Operations

• search_users - Search for users by name or email
• get_user - Get detailed user information by ID or email

Teams Operations

• list_teams - List user’s joined teams
• list_channels - List channels in a specific team
• get_channel_messages - Retrieve messages from a team channel with pagination and filtering
• send_channel_message - Send a message to a team channel
• list_team_members - List members of a specific team

Chat Operations

• list_chats - List user’s chats (1:1 and group)
• get_chat_messages - Retrieve messages from a specific chat with pagination and filtering
• send_chat_message - Send a message to a chat
• create_chat - Create a new 1:1 or group chat

Search Operations

• search_messages - Search across all Teams messages using KQL syntax
• get_recent_messages - Get recent messages with advanced filtering options
• get_my_mentions - Find messages mentioning the current user

📋 Examples

Authentication

First, authenticate with Microsoft Graph:

npx @floriscornel/teams-mcp@latest authenticate

Check your authentication status:

npx @floriscornel/teams-mcp@latest check

Logout if needed:

npx @floriscornel/teams-mcp@latest logout

Integrating with Cursor/Claude

This MCP server is designed to work with AI assistants like Claude/Cursor/VS Code through the Model Context Protocol.

{
  "mcpServers": {
    "teams-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@floriscornel/teams-mcp@latest"
      ]
    }
  }
}

🔒 Security

• All authentication is handled through Microsoft’s OAuth 2.0 flow
• Tokens are securely stored and automatically refreshed
• No sensitive data is logged or exposed
• Follows Microsoft Graph API security best practices

📝 License

MIT License - see LICENSE file for details

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run linting and formatting
5. Submit a pull request

📞 Support

For issues and questions:

• Check the existing GitHub issues
• Review Microsoft Graph API documentation
• Ensure proper authentication and permissions are configured