---
id: microsoft-teams-apps
version: "2.0.15"
license: MIT
license_treatment: permissive
maintenance: active
---

# microsoft-teams-apps — The app package for a Microsoft Teams agent

License: permissive · Maintenance: active · Downloads: 721.3K/mo

## What it is and what it does

microsoft-teams-apps is a high-level framework for building Microsoft Teams applications in Python. It provides decorator-based routing for different activity types (messages, etc.), built-in OAuth flow handling for user authentication, and type-safe access to Microsoft Graph via user_graph and app_graph properties. The framework sits on top of fastapi and uvicorn, handling the HTTP server and activity dispatch.

The package targets Python 3.11+ and includes an extensible plugin system. Graph functionality is optional and requires additional dependencies installed via the [graph] extra; if not installed, Graph access raises ImportError. For local development, JWT validation can be disabled via a flag or environment variable. The framework is newly released and actively maintained.

Use it for:

- Build a Teams bot that routes incoming messages to handler functions using decorators and responds in real time.
- Implement OAuth-based sign-in flows so users can authenticate and access their own Microsoft Graph data within Teams.
- Access Microsoft Graph on behalf of the app to query organizational data or perform admin operations.
- Extend the framework with custom plugins to add domain-specific functionality to Teams applications.
- Develop and test Teams applications locally with JWT validation disabled for faster iteration.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Framework for building Microsoft Teams applications with decorator-based activity routing, OAuth authentication, and Microsoft Graph integration.

Yes, if you are building Microsoft Teams applications in Python. Low install friction, permissive license, active maintenance, and no known vulnerabilities. The framework is newly released so production readiness and community adoption are not yet established; verify that its API stability and feature set match your requirements before committing to production deployment.

## Install

pip install microsoft-teams-apps
uv add microsoft-teams-apps
poetry add microsoft-teams-apps

## Installing microsoft-teams-apps

Before you install: Low install friction with a pure Python wheel. Active maintenance status (released 2026-08-04, 10 days old). Depends on 10 runtime packages including fastapi, uvicorn, and Microsoft-specific libraries.

License in practice: MIT license (permissive) allows commercial and private use with minimal restrictions.

Quickstart:

pip install microsoft-teams-apps

from microsoft_teams.apps import App, ActivityContext
from microsoft_teams.api import MessageActivity

app = App()

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    await ctx.send(f"You said: {ctx.activity.text}")

await app.start()

Requires Python 3.11 or later. Graph functionality requires optional dependencies installed via [graph] extra; without them, user_graph and app_graph raise ImportError when accessed.

Verify before relying:

- Whether the plugin system is documented with examples for extending the framework
- Performance characteristics under high message volume or concurrent activity handling
- Compatibility guarantees with specific Microsoft Teams API versions

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 721.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

microsoft teams bot framework, teams app development, teams activity routing, teams oauth authentication, microsoft graph integration teams, teams bot with graph api, teams application framework, teams-bot, oauth, graph-api

[View on SkillFed](https://skillfed.io/packages/microsoft-teams-apps) · [View on PyPI](https://pypi.org/project/microsoft-teams-apps/)