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: 2 months 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 (3 months ago)
- Default Branch: master
- Last Pushed: 2025-04-11T11:49:16.000Z (2 months ago)
- Last Synced: 2025-04-11T13:16:48.119Z (2 months 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
- mcp-index - Teams Server - Integrates Microsoft Teams to facilitate advanced messaging capabilities, enabling users to read, create, and reply to messages while managing team interactions. Automates message handling and user mentions to improve communication efficiency. (Email and Messaging)
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.)