Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/inditextech--mcp-teams-server/badge.svg)](/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

i

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)

  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. # MCP Teams Server
  9. An MCP ([Model Context Protocol](https://modelcontextprotocol.io/introduction)) server implementation for
  10. [Microsoft Teams](https://www.microsoft.com/en-us/microsoft-teams/group-chat-software/) integration, providing capabilities to
  11. read messages, create messages, reply to messages, mention members.
  12. ## Features
  13. https://github.com/user-attachments/assets/548a9768-1119-4a2d-bd5c-6b41069fc522
  14. - Start thread in channel with title and contents, mentioning users
  15. - Update existing threads with message replies, mentioning users
  16. - Read thread replies
  17. - List channel team members
  18. - Read channel messages
  19. ## Prerequisites
  20. - [uv](https://github.com/astral-sh/uv) package manager
  21. - [Python 3.12](https://www.python.org/)
  22. - Microsoft Teams account with [proper set-up](./doc/MS-Teams-setup.md)
  23. ## Installation
  24. 1. Clone the repository:
  25. ```bash
  26. git clone https://github.com/InditexTech/mcp-teams-server
  27. cd mcp-teams-server
  28. ```
  29. 2. Create a virtual environment and install dependencies:
  30. ```bash
  31. uv venv
  32. uv sync --frozen --all-extras --dev
  33. ```
  34. ## Teams configuration
  35. Please read [this document](./doc/MS-Teams-setup.md) to help you to configure Microsoft Teams and required
  36. Azure resources. It is not a step-by-step guide but can help you figure out what you will need.
  37. ## Usage
  38. Set up the following environment variables in your shell or in an .env file. You can use [sample file](./sample.env)
  39. as a template:
  40. | Key | Description |
  41. |-------------------------|--------------------------------------------|
  42. | **TEAMS_APP_ID** | UUID for your MS Entra ID application ID |
  43. | **TEAMS_APP_PASSWORD** | Client secret |
  44. | **TEAMS_APP_TENANT_ID** | Tenant uuid in case of SingleTenant |
  45. | **TEAM_ID** | MS Teams Group Id or Team Id |
  46. | **TEAMS_CHANNEL_ID** | MS Teams Channel ID with url escaped chars |
  47. Start the server:
  48. ```bash
  49. uv run mcp-teams-server
  50. ```
  51. The default MCP transport is `stdio`. You can also use `streamable-http` for HTTP deployments:
  52. ```bash
  53. uv run mcp-teams-server --transport streamable-http
  54. ```
  55. The legacy `sse` transport is still available for older clients.
  56. ## Development
  57. Integration tests require the set-up the following environment variables:
  58. | Key | Description |
  59. |------------------------|--------------------------------|
  60. | **TEST_THREAD_ID** | timestamp of the thread id |
  61. | **TEST_MESSAGE_ID** | timestamp of the message id |
  62. | **TEST_USER_NAME** | test user name |
  63. ```bash
  64. uv run pytest -m integration
  65. ```
  66. ### Pre-built docker image
  67. There is a [pre-built image](https://github.com/InditexTech/mcp-teams-server/pkgs/container/mcp-teams-server) hosted in ghcr.io.
  68. You can install this image by running the following command
  69. ```commandline
  70. docker pull ghcr.io/inditextech/mcp-teams-server:latest
  71. ```
  72. ### Build docker image
  73. A docker image is available to run MCP server. You can build it with the following command:
  74. ```bash
  75. docker build . -t inditextech/mcp-teams-server
  76. ```
  77. ### Run docker image
  78. Basic run configuration:
  79. ```bash
  80. docker run -it inditextech/mcp-teams-server
  81. ```
  82. Run with environment variables from .env file:
  83. ```bash
  84. docker run --env-file .env -it inditextech/mcp-teams-server
  85. ```
  86. Run with Streamable HTTP transport:
  87. ```bash
  88. docker run --env-file .env -p 8000:8000 -it inditextech/mcp-teams-server --transport streamable-http
  89. ```
  90. ### Setup LLM to use MCP Teams Server
  91. Please follow instructions on the [following document](./llms-install.md)
  92. ## Changelog
  93. See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.
  94. ## Contributing
  95. Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull
  96. requests.
  97. ## Security
  98. For security concerns, please see our [Security Policy](SECURITY.md).
  99. ## License
  100. This project is licensed under the [Apache-2.0](LICENSE.txt) file for details.
  101. © 2025 INDUSTRIA DE DISEÑO TEXTIL S.A. (INDITEX S.A.)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.