You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.
An MCP (Model Context Protocol) server implementation for
Microsoft Teams integration, providing capabilities to
read messages, create messages, reply to messages, mention members.
Features
MCP-Teams-Server-Showcase.mp4
Start thread in channel with title and contents, mentioning users
Update existing threads with message replies, mentioning users
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
An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.