Microsoft Teams

What is MCP Teams Server?

MCP Teams Server is an implementation of the Model Context Protocol (MCP) designed to integrate with Microsoft Teams. It acts as a server that allows external applications to interact with Microsoft Teams messaging functionalities programmatically. This includes reading, creating, and replying to messages, as well as mentioning users within Teams conversations.

How to use MCP Teams Server?

To use MCP Teams Server, you first need to clone the repository and install the necessary dependencies using uv package manager. Before running the server, you must configure several environment variables, including TEAMS_APP_ID, TEAMS_APP_PASSWORD, TEAMS_APP_TYPE, TEAMS_APP_TENANT_ID, TEAM_ID, and TEAMS_CHANNEL_ID. A detailed guide for Microsoft Teams and Azure resource configuration is provided in the project documentation. Once configured, you can start the server using uv run mcp-teams-server. For containerized deployment, a pre-built Docker image is available, or you can build your own.

Key Features of MCP Teams Server

• Message Management: Start new threads in channels with titles and content, and update existing threads with replies.
• User Mentions: Ability to mention specific users in messages and threads.
• Message Reading: Read messages and thread replies within channels.
• Team Member Listing: List all members of a channel.
• LLM Integration: Provides instructions for setting up Large Language Models (LLMs) to utilize the MCP Teams Server.

Use Cases of MCP Teams Server

• Automated Notifications: Send automated notifications or alerts from other systems directly into Microsoft Teams channels.
• Chatbot Development: Build custom chatbots that can interact with users in Teams, respond to queries, and manage conversations.
• Workflow Automation: Integrate Teams messaging into broader business workflows, allowing for automated message posting based on triggers from other applications.
• Customer Support: Create systems that can automatically reply to customer queries in Teams or escalate issues by mentioning relevant team members.
• Data Collection: Read messages from Teams channels to collect data for analysis or archiving purposes.

FAQ from MCP Teams Server

Q: What are the prerequisites for running MCP Teams Server? A: You need uv package manager, Python 3.10, and a Microsoft Teams account with proper setup as detailed in the MS-Teams-setup.md document.

Q: How do I configure Microsoft Teams for use with MCP Teams Server? A: Refer to the MS-Teams-setup.md document in the project for guidance on configuring Microsoft Teams and required Azure resources.

Q: Is there a Docker image available for MCP Teams Server? A: Yes, a pre-built Docker image is available on ghcr.io/inditextech/mcp-teams-server:latest. You can also build your own Docker image.

Q: How can I set up an LLM to use MCP Teams Server? A: Instructions for setting up an LLM are provided in the llms-install.md document within the project.

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.

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 package manager
• Python 3.10
• Microsoft Teams account with proper set-up

Installation

1. Clone the repository:

git clone [repository-url]
cd mcp-teams-server

2. Create a virtual environment and install dependencies:

uv venv
uv sync --frozen --all-extras --dev

Teams configuration

Please read this document 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 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:

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

uv run pytest -m integration

Pre-built docker image

There is a pre-built image hosted in ghcr.io. You can install this image by running the following command

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:

docker build . -t inditextech/mcp-teams-server

Run docker image

Basic run configuration:

docker run -it inditextech/mcp-teams-server

Run with environment variables from .env file:

docker run --env-file .env -it inditextech/mcp-teams-server

Setup LLM to use MCP Teams Server

Please follow instructions on the following document

Changelog

See CHANGELOG.md for a list of changes and version history.

Contributing

Please read 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.

License

This project is licensed under the Apache-2.0 file for details.

© 2025 INDUSTRIA DE DISEÑO TEXTIL S.A. (INDITEX S.A.)