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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/inditextech--mcp-teams-server)HTML
<a href="/listings/inditextech--mcp-teams-server"><img src="/api/listings/inditextech--mcp-teams-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Clone the repository:
git clone https://github.com/InditexTech/mcp-teams-server cd mcp-teams-server
2. Create a virtual environment and install dependencies:
uv venv uv sync --frozen --all-extras --dev
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 153 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- [](https://sonarcloud.io/summary/new_code?id=InditexTech_mcp-teams-server)
- [](https://sonarcloud.io/summary/new_code?id=InditexTech_mcp-teams-server)
- [](https://sonarcloud.io/summary/new_code?id=InditexTech_mcp-teams-server)
- 
- 
- [](https://scorecard.dev/viewer/?uri=github.com/InditexTech/mcp-teams-server)
- <!-- [](https://www.bestpractices.dev/projects/10400) -->
- # MCP Teams Server
- An MCP ([Model Context Protocol](https://modelcontextprotocol.io/introduction)) server implementation for
- [Microsoft Teams](https://www.microsoft.com/en-us/microsoft-teams/group-chat-software/) 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](https://github.com/astral-sh/uv) package manager
- - [Python 3.12](https://www.python.org/)
- - Microsoft Teams account with [proper set-up](./doc/MS-Teams-setup.md)
- ## Installation
- 1. Clone the repository:
- ```bash
- git clone https://github.com/InditexTech/mcp-teams-server
- cd mcp-teams-server
- ```
- 2. Create a virtual environment and install dependencies:
- ```bash
- 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 |
- |-------------------------|--------------------------------------------|
- | **TEAMS_APP_ID** | UUID for your MS Entra ID application ID |
- | **TEAMS_APP_PASSWORD** | Client secret |
- | **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:
- ```bash
- uv run mcp-teams-server
- ```
- The default MCP transport is `stdio`. You can also use `streamable-http` for HTTP deployments:
- ```bash
- uv run mcp-teams-server --transport streamable-http
- ```
- The legacy `sse` transport is still available for older clients.
- ## 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 |
- ```bash
- uv run pytest -m integration
- ```
- ### Pre-built docker image
- There is a [pre-built image](https://github.com/InditexTech/mcp-teams-server/pkgs/container/mcp-teams-server) hosted in ghcr.io.
- You can install this image by running the following command
- ```commandline
- 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:
- ```bash
- docker build . -t inditextech/mcp-teams-server
- ```
- ### Run docker image
- Basic run configuration:
- ```bash
- docker run -it inditextech/mcp-teams-server
- ```
- Run with environment variables from .env file:
- ```bash
- docker run --env-file .env -it inditextech/mcp-teams-server
- ```
- Run with Streamable HTTP transport:
- ```bash
- docker run --env-file .env -p 8000:8000 -it inditextech/mcp-teams-server --transport streamable-http
- ```
- ### 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.)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.