MCP Teams Server

1[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=InditexTech_mcp-teams-server&metric=bugs)](https://sonarcloud.io/summary/new_code?id=InditexTech_mcp-teams-server)
2[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=InditexTech_mcp-teams-server&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=InditexTech_mcp-teams-server)
3[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=InditexTech_mcp-teams-server&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=InditexTech_mcp-teams-server)
4![GitHub License](https://img.shields.io/github/license/InditexTech/mcp-teams-server)
5![GitHub Release](https://img.shields.io/github/v/release/InditexTech/mcp-teams-server)
6[![Scorecard](https://api.scorecard.dev/projects/github.com/InditexTech/mcp-teams-server/badge)](https://scorecard.dev/viewer/?uri=github.com/InditexTech/mcp-teams-server)
7<!-- [![Best Practices](https://www.bestpractices.dev/projects/10400/badge)](https://www.bestpractices.dev/projects/10400) -->
8 
9 
10# MCP Teams Server
11 
12An MCP ([Model Context Protocol](https://modelcontextprotocol.io/introduction)) server implementation for 
13[Microsoft Teams](https://www.microsoft.com/en-us/microsoft-teams/group-chat-software/) integration, providing capabilities to 
14read messages, create messages, reply to messages, mention members.
15 
16## Features
17 
18https://github.com/user-attachments/assets/548a9768-1119-4a2d-bd5c-6b41069fc522
19 
20- Start thread in channel with title and contents, mentioning users
21- Update existing threads with message replies, mentioning users
22- Read thread replies
23- List channel team members
24- Read channel messages
25 
26## Prerequisites
27 
28- [uv](https://github.com/astral-sh/uv) package manager
29- [Python 3.10](https://www.python.org/)
30- Microsoft Teams account with [proper set-up](./doc/MS-Teams-setup.md)
31 
32## Installation
33 
341. Clone the repository:
35 
36```bash
37git clone [repository-url]
38cd mcp-teams-server
39```
40 
412. Create a virtual environment and install dependencies:
42 
43```bash
44uv venv
45uv sync --frozen --all-extras --dev
46```
47 
48## Teams configuration
49 
50Please read [this document](./doc/MS-Teams-setup.md) to help you to configure Microsoft Teams and required 
51Azure resources. It is not a step-by-step guide but can help you figure out what you will need.
52 
53## Usage
54 
55Set up the following environment variables in your shell or in an .env file. You can use [sample file](./sample.env) 
56as a template:
57 
58| Key                     | Description                                |
59|-------------------------|--------------------------------------------|
60| **TEAMS_APP_ID**        | UUID for your MS Entra ID application ID   |
61| **TEAMS_APP_PASSWORD**  | Client secret                              |
62| **TEAMS_APP_TYPE**      | SingleTenant or MultiTenant                |
63| **TEAMS_APP_TENANT_ID** | Tenant uuid in case of SingleTenant        |
64| **TEAM_ID**             | MS Teams Group Id or Team Id               |
65| **TEAMS_CHANNEL_ID**    | MS Teams Channel ID with url escaped chars |
66 
67Start the server:
68 
69```bash
70uv run mcp-teams-server
71```
72 
73## Development
74 
75Integration tests require the set-up the following environment variables:
76 
77| Key                    | Description                    |
78|------------------------|--------------------------------|
79| **TEST_THREAD_ID**     | timestamp of the thread id     |
80| **TEST_MESSAGE_ID**    | timestamp of the message id    |
81| **TEST_USER_NAME**     | test user name                 |
82 
83 
84```bash
85uv run pytest -m integration
86```
87 
88### Pre-built docker image
89 
90There is a [pre-built image](https://github.com/InditexTech/mcp-teams-server/pkgs/container/mcp-teams-server) hosted in ghcr.io.
91You can install this image by running the following command
92 
93```commandline
94docker pull ghcr.io/inditextech/mcp-teams-server:latest
95```
96 
97### Build docker image
98 
99A docker image is available to run MCP server. You can build it with the following command:
100 
101```bash
102docker build . -t inditextech/mcp-teams-server
103```
104 
105### Run docker image
106 
107Basic run configuration:
108 
109```bash
110docker run -it inditextech/mcp-teams-server
111```
112 
113Run with environment variables from .env file:
114 
115```bash
116docker run --env-file .env -it inditextech/mcp-teams-server
117```
118 
119### Setup LLM to use MCP Teams Server
120 
121Please follow instructions on the [following document](./llms-install.md)
122 
123## Changelog
124 
125See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.
126 
127## Contributing
128 
129Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull
130requests.
131 
132## Security
133 
134For security concerns, please see our [Security Policy](SECURITY.md).
135 
136## License
137 
138This project is licensed under the [Apache-2.0](LICENSE.txt) file for details.
139 
140© 2025 INDUSTRIA DE DISEÑO TEXTIL S.A. (INDITEX S.A.)
141