home / mcp / microsoft teams mcp server
Provides a Microsoft Teams notification channel by sending messages via a Teams bot using MCP.
Configuration
View docs{
"mcpServers": {
"therealjohn-microsoft-teams-mcp": {
"command": "uv",
"args": [
"--directory",
"<path/to/the/project>/microsoft-teams-mcp",
"run",
"microsoft-teams-mcp"
],
"env": {
"EMAIL": "<your-email-in-teams>",
"BOT_ENDPOINT": "<endpoint or dev tunnel URL of Teams bot>/api/notification",
"MICROSOFT_APP_ID": "<microsoft-entra-client-id>",
"MICROSOFT_APP_PASSWORD": "<microsoft-entra-client-secret>",
"MICROSOFT_APP_TENANT_ID": "<microsoft-entra-tenant-id>"
}
}
}
}You set up this MCP server to send notifications to Microsoft Teams from your MCP client. It runs locally and uses a Teams bot for secure messaging, letting your projects post alerts or updates directly into Teams channels with Markdown formatting support.
To send a notification from your MCP client, use the Microsoft Teams MCP server tool named Microsoft Teams. It exposes a single action, send-notification, which accepts a message and a project as inputs. Your client can trigger this action whenever you need to post an update to Teams. The integration uses Azure AD authentication to securely communicate with Teams, ensuring your messages come from trusted sources.
Prerequisites - You need the MCP tooling that provides the uv command. Ensure it is available in your development environment.
1) Clone the project repository to your development machine.
2) Install dependencies (if your setup requires installing package dependencies for MCP tooling).
3) Build the package distributions if your workflow requires building before running.
4) Start the Microsoft Teams MCP server using the runtime command shown below. You will run from your project root and point to the Microsoft Teams MCP module.
uv --directory <path/to/the/project>/microsoft-teams-mcp run microsoft-teams-mcpConfiguration options require a Microsoft Teams bot to receive notifications. Set the following environment variables in your environment or a .env file at the project root to enable authentication and notification delivery:
Your server uses Azure AD authentication to securely communicate with Teams. Set these environment variables with appropriate values for your Azure AD app registration and Teams bot:
If notifications do not appear in Teams, verify that your bot endpoint is reachable, the Azure AD app credentials are correct, and the email address you configured matches a recipient in Teams.
Sends a notification message to Microsoft Teams. Requires message and project. Supports Markdown formatting and uses Azure AD authentication to securely reach Teams.