teams-mcp

Overview

This MCP server provides seamless integration with Microsoft Graph APIs, enabling AI assistants to interact with Microsoft Teams, users, chats, files, and organizational data. It offers robust features including OAuth 2.0 authentication, user management, team operations, channel management, chat & messaging capabilities, message management, media & attachments handling, and advanced search functionality. The server supports both read-only and full access modes with comprehensive documentation and examples.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• auth_status

  Check current authentication status

  Try:Check if I'm authenticatedTry:Show my Teams authentication status
• get_current_user

  Get authenticated user information

  Try:Who am I in Teams?Try:Get my user profile
• search_users

  Search for users by name or email

  Try:Find John Smith in TeamsTry:Search for users with email domain @company.com
• get_user

  Get detailed user information by ID or email

  Try:Get details for user@example.comTry:Show profile for user ID 12345
• list_teams

  List user's joined teams

  Try:Show all my TeamsTry:List the teams I'm a member of
• list_channels

  List channels in a specific team

  Try:Show channels in the Marketing teamTry:List all channels for team ID 12345
• get_channel_messages

  Retrieve messages from a team channel

  Try:Show recent messages in General channelTry:Get messages from team 123, channel 456
• send_channel_message

  Send a message to a team channel

  Try:Post in the General channelTry:Send a message to team 123 channel 456
• get_chat_messages

  Retrieve messages from a 1:1 or group chat

  Try:Show messages in my chat with JohnTry:Get recent messages from group chat 19:meeting_123
• send_chat_message

  Send a message to a 1:1 or group chat

  Try:Message John SmithTry:Send a message to my team group chat
• create_chat

  Create a new 1:1 or group conversation

  Try:Start a chat with Jane DoeTry:Create a group chat with John and Sarah
• search_messages

  Search across Teams channels and chats

  Try:Find messages about project XTry:Search for messages from last week

Comparable tools

Installation

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

npm install @floriscornel/teams-mcp

npx @floriscornel/teams-mcp@latest authenticate  # Full access
npx @floriscornel/teams-mcp@latest authenticate --read-only  # Read-only access

FAQ

How does authentication work?

The server supports OAuth 2.0 device code authentication flow with Microsoft Graph. You can authenticate using CLI commands or provide a pre-existing Microsoft Graph JWT token through environment variables.

Does it support file uploads?

Yes, it supports uploading any file type (PDF, DOCX, XLSX, ZIP, images, etc.) to channels and chats, with large file support (>4 MB) via resumable upload sessions.

Compare teams-mcp with