Mcp Teams Server

[](https://sonarcloud.io/summary/newcode?id=InditexTechmcp-teams-server) [](https://sonarcloud.io/summary/newcode?id=InditexTechmcp-teams-server) [](https://sonarcloud.io/summary/newcode?id=InditexTechmcp-teams-server)

[](https://scorecard.dev/viewer/?uri=github.com/InditexTech/mcp-teams-server)

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

https://github.com/user-attachments/assets/548a9768-1119-4a2d-bd5c-6b41069fc522

• 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](./doc/MS-Teams-setup.md)

Installation

1. Clone the repository:

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

1. Create a virtual environment and install dependencies:

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

Teams configuration

Please read [this document](./doc/MS-Teams-setup.md) 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](./sample.env) as a template:

| Key | Description | |-------------------------|--------------------------------------------| | TEAMSAPPID | UUID for your MS Entra ID application ID | | TEAMSAPPPASSWORD | Client secret | | TEAMSAPPTYPE | SingleTenant or MultiTenant | | TEAMSAPPTENANTID | Tenant uuid in case of SingleTenant | | TEAMID | MS Teams Group Id or Team Id | | TEAMSCHANNELID | 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 | |------------------------|--------------------------------| | TESTTHREADID | timestamp of the thread id | | TESTMESSAGEID | timestamp of the message id | | TESTUSERNAME | test user name |

uv run pytest -m integration

Pre-built docker image

There is a pre-built image hosted in ghcr.io. You can install this image by running the following command

docker pull ghcr.io/inditextech/mcp-teams-server:latest

Build docker image

A docker image is available to run MCP server. You can build it with the following command:

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](./llms-install.md)

Changelog

See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.

Contributing

Please read [CONTRIBUTING.md](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](SECURITY.md).

License

This project is licensed under the [Apache-2.0](LICENSE.txt) file for details.

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: InditexTech
• Source: InditexTech/mcp-teams-server
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.