Microsoft Teams

Provides a Microsoft Teams notification channel by sending messages via a Teams bot using MCP.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

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.

How to use

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.

How to install

Prerequisites

You need the MCP tooling that provides the uv command. Ensure it is available in your development environment.

Clone the project repository to your development machine.
Install dependencies (if your setup requires installing package dependencies for MCP tooling).
Build the package distributions if your workflow requires building before running.
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-mcp

Additional notes

Configuration 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:

Security and environment variables

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:

Troubleshooting and tips

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.

Available tools

send-notification

Sends a notification message to Microsoft Teams. Requires message and project. Supports Markdown formatting and uses Azure AD authentication to securely reach Teams.

Built by

VeilStrat

AI signals for GTM teams