Msteams MCP Server

[giscus[bot]]

Msteams MCP Server

https://mcp.so/server/msteams/InditexTech

[marianoao]

MCP Teams Server Installation Guide

This guide is specifically designed for AI agents like Cline to install and configure the MCP Teams Server for use
with LLM applications like Claude Desktop, Cursor, Roo Code, and Cline.

Overview

MCP Teams Server is a communication tool that allows AI assistants to interact with Microsoft Teams Channels.

Prerequisites

• uv package manager
• Python 3.10
• Microsoft Teams account with proper set-up

Installation and configuration

Add the MCP server configuration to your MCP settings file based on your LLM client.

Sample docker setup:

{
  "mcpServers": {
    "msteams": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TEAMS_APP_ID",
        "-e",
        "TEAMS_APP_PASSWORD",
        "-e",
        "TEAMS_APP_TYPE",
        "-e",
        "TEAMS_APP_TENANT_ID",
        "-e",
        "TEAM_ID",
        "-e",
        "TEAMS_CHANNEL_ID",
        "ghcr.io/inditextech/mcp-teams-server"
      ],
      "env": {
        "TEAMS_APP_ID": "<fill_me_with_proper_uuid>",
        "TEAMS_APP_PASSWORD": "<fill_me_with_proper_uuid>",
        "TEAMS_APP_TYPE": "<fill_me_with_proper_uuid>",
        "TEAMS_APP_TENANT_ID": "<fill_me_with_proper_uuid>",
        "TEAM_ID": "<fill_me_with_proper_uuid>",
        "TEAMS_CHANNEL_ID": "<fill_me_with_proper_channel_id>",
        "DOCKER_HOST": "unix:///var/run/docker.sock"
      }
    }
  }
}

Sample Cline setup with docker through WSL (Windows only):

{
  "mcpServers": {
    "github.com/InditexTech/mcp-teams-server/tree/main": {
      "command": "wsl",
      "args": [
        "TEAMS_APP_ID=<fill_me_with_proper_uuid>",
        "TEAMS_APP_PASSWORD=<fill_me_with_proper_uuid>",
        "TEAMS_APP_TYPE=<fill_me_with_proper_uuid>",
        "TEAMS_APP_TENANT_ID=<fill_me_with_proper_uuid>",
        "TEAM_ID=<fill_me_with_proper_uuid>",
        "TEAMS_CHANNEL_ID=<fill_me_with_proper_uuid>",
        "docker",
        "run",
        "-i",
        "--rm",
        "ghcr.io/inditextech/mcp-teams-server"
      ],
      "env": {
        "DOCKER_HOST": "unix:///var/run/docker.sock"
      },
      "disabled": false,
      "autoApprove": [ ],
      "timeout": 300
    }
  }
}

Sample local development setup:

{
  "mcpServers": {
    "msteams": {
      "command": "uv",
      "args": [
        "run",
        "mcp-teams-server"
      ],
      "env": {
        "TEAMS_APP_ID": "<fill_me_with_proper_uuid>",
        "TEAMS_APP_PASSWORD": "<fill_me_with_proper_uuid>",
        "TEAMS_APP_TYPE": "<fill_me_with_proper_uuid>",
        "TEAMS_APP_TENANT_ID": "<fill_me_with_proper_uuid>",
        "TEAM_ID": "<fill_me_with_proper_uuid>",
        "TEAMS_CHANNEL_ID": "<fill_me_with_proper_channel_id>"
      }
    }
  }
}

Verify installation

Once configured, you'll have access to these tools:

1. start_thread

Start a new thread with a given title and content

Parameters:

• title: (Required) The thread title
• content: (Required) The thread content
• member_name: (Optional) Member name to mention in the thread

2. update_thread

Update an existing thread with new content

Parameters:

• thread_id: (Required) The thread ID as a string in the format '1743086901347'
• content: (Required) The content to update in the thread
• member_name: (Optional) Member name to mention in the thread

3. read_thread

Read replies in a thread

Parameters:

• thread_id: (Required) The thread ID as a string in the format '1743086901347'

4. list_threads

List threads in channel with pagination

Parameters:

• limit: (Optional, default 50) Maximum number of items to retrieve or page size
• cursor: (Optional) Pagination cursor for the next page of results, returned by previous list_thread tool call.

5. get_member_by_name

Get a member by its name

Parameters:

• name: (Required) Member name

6. list_members

List all members in the team

Usage Examples

Some ideas for user prompts are:

Please start a thread in teams with the following content... 

Please list members in team

Please perform this task... and send results to a new thread in teams. Remember to mention "User Name"

Please read latest team threads and reply to threads that mention "Your bot name" 

[marianoao]

MCP Teams Server

An MCP (Model Context Protocol) server implementation for
Microsoft Teams integration, providing capabilities to
read messages, create messages, reply to messages, mention members.

Features

MCP-Teams-Server-Showcase.mp4

• Start thread in channel with title and contents, mentioning users
• Update existing threads with message replies, mentioning users
• Read thread replies
• List channel team members
• Read channel messages

Prerequisites

• uv package manager
• Python 3.10
• Microsoft Teams account with proper set-up

Installation

1. Clone the repository:

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

2. Create a virtual environment and install dependencies:

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

Teams configuration

Please read this document to help you to configure Microsoft Teams and required
Azure resources. It is not a step-by-step guide but can help you figure out what you will need.

Usage

Set up the following environment variables in your shell or in an .env file. You can use sample file
as a template:

Key	Description
TEAMS_APP_ID	UUID for your MS Entra ID application ID
TEAMS_APP_PASSWORD	Client secret
TEAMS_APP_TYPE	SingleTenant or MultiTenant
TEAMS_APP_TENANT_ID	Tenant uuid in case of SingleTenant
TEAM_ID	MS Teams Group Id or Team Id
TEAMS_CHANNEL_ID	MS Teams Channel ID with url escaped chars

Start the server:

uv run mcp-teams-server

Development

Integration tests require the set-up the following environment variables:

Key	Description
TEST_THREAD_ID	timestamp of the thread id
TEST_MESSAGE_ID	timestamp of the message id
TEST_USER_NAME	test user name

uv run pytest -m integration

Build docker image

A docker image is available to run MCP server:

docker build . -t InditexTech/mcp-teams-server

Run docker image

Basic run configuration:

docker run -it InditexTech/mcp-teams-server

Run with environment variables from .env file:

docker run --env-file .env -it InditexTech/mcp-teams-server

Setup LLM to use MCP Teams Server

Please follow instructions on the following document

Changelog

See CHANGELOG.md for a list of changes and version history.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull
requests.

Security

For security concerns, please see our Security Policy.

License

This project is licensed under the Apache-2.0 file for details.

© 2025 INDUSTRIA DE DISEÑO TEXTIL S.A. (INDITEX S.A.)