A comprehensive SDK for building Microsoft Teams applications, bots, and AI agents using Python. This SDK provides a high-level framework with built-in Microsoft Graph integration, OAuth handling, and extensible plugin architecture.

• Questions or Feature Requests: Please use GitHub Discussions

• Bug Reports: Please open an issue

• Getting Started

• Packages

• Test Apps

• Links

• UV version is >= 0.8.11. Install and upgrade from docs.astral.sh/uv.
• Python version is >= 3.12. Install or upgrade from python.org/downloads.
• (Optional) .NET SDK + nbgv CLI for real version numbers. Without it, packages build as 0.0.0 which is fine for local development. See RELEASE.md for details.

 uv sync --all-packages --group dev

Note: After the initial setup, you need to activate the virtual environment each time you start a new terminal session

# On Mac
 `source .venv/bin/activate`

# On Windows
 `.venv\Scripts\Activate`

 pre-commit install

ℹ️ core packages used to build client/server apps for Teams.

• microsoft-teams-apps
• microsoft-teams-api
• microsoft-teams-cards
• microsoft-teams-common
• microsoft-teams-graph
• microsoft-teams-botbuilder

We use cookiecutter to create new packages. To create a new package, run:

cookiecutter templates/package -o packages

Follow the prompts to name the package and the directory. It should create the package folder in the packages directory.

Similarly, to create a new test app, run:

cookiecutter templates/examples -o examples

ℹ️ used to test the SDK or as a visual sample of how certain features can be implemented.

⚠️ WARNING these apps are changed often and are not intended to be used outside the projects monorepo. To easily setup a new project please use the templates available via the @microsoft/teams.cli and follow the Getting Started documentation!

• @examples/echo
• @examples/message-extensions
• @examples/dialogs
• @examples/graph
• @examples/stream
• @examples/oauth
• @examples/meetings

• Teams Developer Portal: Apps
• Teams Toolkit