mcp-teams-server
An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to mes...
Documentation
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.12
- Microsoft Teams account with proper set-up
Installation
1. Clone the repository:
git clone https://github.com/InditexTech/mcp-teams-server
cd mcp-teams-server2. Create a virtual environment and install dependencies:
uv venv
uv sync --frozen --all-extras --devTeams 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_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-serverThe default MCP transport is `stdio`. You can also use `streamable-http` for HTTP deployments:
uv run mcp-teams-server --transport streamable-httpThe legacy `sse` transport is still available for older clients.
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 integrationPre-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:latestBuild 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-serverRun docker image
Basic run configuration:
docker run -it inditextech/mcp-teams-serverRun with environment variables from .env file:
docker run --env-file .env -it inditextech/mcp-teams-serverRun with Streamable HTTP transport:
docker run --env-file .env -p 8000:8000 -it inditextech/mcp-teams-server --transport streamable-httpSetup 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.)
Frequently asked questions
What is mcp-teams-server?
mcp-teams-server is An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to mes...
How do I install mcp-teams-server?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-teams-server open source?
Yes, it is hosted on GitHub at https://github.com/InditexTech/mcp-teams-server and has 329 stars.
Related MCP tools
An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Python-based implementation. Trusted by 11000+ developers.
AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP. Python-based implementation. Trusted by 4100+ developers.
An MCP server that autonomously evaluates web applications. Python-based implementation. Trusted by 1100+ developers. Trusted by 1100+ developers.
An official Qdrant Model Context Protocol (MCP) server implementation Python-based implementation. Trusted by 1000+ developers.
A middleware to provide an openAI compatible endpoint that can call MCP tools Python-based implementation. Trusted by 800+ developers.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP