mcp-teams-server

Overview

This is a production-ready MCP server implementation for Microsoft Teams that provides comprehensive integration capabilities. It allows reading messages, creating new messages, replying to threads, and mentioning team members. The server uses Python and has clear documentation with installation guides for both direct execution and Docker deployment. It includes proper authentication setup through Microsoft Entra ID and supports both single and multi-tenant configurations.

Try asking AI

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

• start_thread

  Start a thread in a channel with title and contents, mentioning users

  Try:Start a thread in the team channel about project updates and mention the team leadsTry:Create a new discussion thread with the title 'Q3 Planning' and mention John and Sarah
• update_thread

  Update existing threads with message replies, mentioning users

  Try:Reply to the project updates thread with new milestones and mention the project managerTry:Add a follow-up comment to the planning thread mentioning the finance team
• read_thread_replies

  Read replies from a thread

  Try:Show me all replies to the project updates threadTry:Get the latest responses in the planning discussion
• list_channel_members

  List channel team members

  Try:Who are the members of this channel?Try:List all team members in the current channel
• read_channel_messages

  Read channel messages

  Try:Show me the recent messages in this channelTry:What are the latest messages in the team channel?

Note: Tool names inferred from the Features section of the README which describes the capabilities but doesn't provide explicit MCP tool names.

Comparable tools

Installation

git clone [repository-url]
cd mcp-teams-server

uv venv
uv sync --frozen --all-extras --dev

export TEAMS_APP_ID="your-app-id"
export TEAMS_APP_PASSWORD="your-password"
export TEAMS_APP_TYPE="SingleTenant" # or "MultiTenant"
export TEAMS_APP_TENANT_ID="your-tenant-id"
export TEAM_ID="your-team-id"
export TEAMS_CHANNEL_ID="your-channel-id"

uv run mcp-teams-server

{
  "mcpServers": {
    "teams": {
      "command": "uv",
      "args": ["run", "mcp-teams-server"],
      "env": {
        "TEAMS_APP_ID": "your-app-id",
        "TEAMS_APP_PASSWORD": "your-password",
        "TEAMS_APP_TYPE": "SingleTenant",
        "TEAMS_APP_TENANT_ID": "your-tenant-id",
        "TEAM_ID": "your-team-id",
        "TEAMS_CHANNEL_ID": "your-channel-id"
      }
    }
  }
}

FAQ

What Microsoft Teams permissions are required for this MCP server?

The server requires Microsoft Graph API permissions for Teams, specifically ChannelMessage.Read.All, Chat.Read, and TeamMember.Read.All scopes to function properly.

Can this MCP server work with personal Microsoft accounts?

No, this server requires setup with Microsoft Entra ID (formerly Azure AD) applications and cannot work with personal Microsoft accounts without proper enterprise configuration.

On Hacker News

Recent discussion from the developer community.

• An MCP server implementation for Microsoft Teams▲ 4
  Story by bpedro · 2025-04-30

Compare mcp-teams-server with