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

# microsoft-teams-api — API package for Microsoft Teams

License: permissive · Maintenance: active · Downloads: 1.0M/mo

## What it is and what it does

microsoft-teams-api is a Python client library for integrating with Microsoft Teams via the Bot Framework. It wraps HTTP communication to Teams APIs and provides typed Pydantic models for activities, authentication flows (ClientCredentials and TokenCredentials), and specialized clients for bots, users, conversations, teams, and meetings. The library handles JWT token operations and validates incoming activity payloads against defined schemas.

Developers use it to build Teams bots and integrations that need to authenticate with Microsoft services, send and receive typed messages, and interact with Teams resources. It depends on microsoft-teams-cards, microsoft-teams-common, pydantic for validation, and pyjwt for token handling. The package targets Python 3.11+ and is maintained actively within the microsoft/teams.py monorepo.

Use it for:

- Build a Teams bot that receives and responds to messages using typed Activity models for validation
- Authenticate with Microsoft Teams APIs using ClientCredentials for service-to-service scenarios
- Fetch bot and user tokens from Teams infrastructure for downstream Graph API calls
- Validate and deserialize incoming Teams activities in a webhook handler

## Worth the install?

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

HTTP client library for Microsoft Teams Bot Framework APIs, providing typed models, authentication handlers, and bot/user/conversation/team/meeting API clients.

Yes, if you are building a Teams bot or integration. The package is actively maintained, has low install friction, carries a permissive MIT license, and provides the core typed API surface needed for Teams Bot Framework work. No known vulnerabilities as of 2026-08-14. Requires Python 3.11+.

## Install

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

## Installing microsoft-teams-api

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a recent commit on 2026-08-13 and a release 10 days ago. Requires Python 3.11 or later.

License in practice: MIT license permits commercial and private use with minimal restrictions, making it suitable for most deployment scenarios.

Quickstart:

pip install microsoft-teams-api

from microsoft_teams.api import ClientCredentials, ApiClient

credentials = ClientCredentials(client_id="app-id", client_secret="app-secret")
api = ApiClient("https://smba.trafficmanager.net/amer/")
token_response = await api.bots.token.get(credentials)

Requires Python 3.11 or later; async/await usage requires an async runtime context.

Verify before relying:

- Whether TokenCredentials accepts a callable or requires pre-fetched tokens
- Scope and completeness of Teams Bot Framework API coverage relative to official Microsoft SDKs
- Whether all API clients support async/await or only specific ones

## Package facts

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

## Tags

microsoft teams bot api client, teams bot framework python, teams activity models, teams authentication client, teams api http client, teams-bot-framework, microsoft-integration

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