microsoft-teams-apps

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 on this page — 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

microsoft-teams-apps on PyPI

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

Evidence: microsoft_teams_apps-2.0.15-py3-none-any.whl

Keywords: agents, ai, bot, microsoft, teams

Tags

More Application Frameworks packages