https://github.com/InditexTech/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.
https://github.com/InditexTech/mcp-teams-server
inditex mcp mcp-server msteams
Last synced: 4 days ago
JSON representation
An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.
- Host: GitHub
- URL: https://github.com/InditexTech/mcp-teams-server
- Owner: InditexTech
- License: apache-2.0
- Created: 2025-03-18T13:03:30.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2025-04-11T11:49:16.000Z (9 days ago)
- Last Synced: 2025-04-11T13:16:48.119Z (9 days ago)
- Topics: inditex, mcp, mcp-server, msteams
- Language: Python
- Homepage:
- Size: 55.6 MB
- Stars: 37
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-mcp-zh - InditexTech/mcp-teams-server
README
[](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)
# 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.10](https://www.python.org/)
- Microsoft Teams account with [proper set-up](./doc/MS-Teams-setup.md)
## Installation
1. Clone the repository:
```bash
git clone [repository-url]
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_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:
```bash
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 |
```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
```
### 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.)