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

# microsoft-teams-common — Common package for Microsoft Teams

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

## What it is and what it does

microsoft-teams-common is a foundational utilities package for the Microsoft Teams Python SDK, offering reusable components that other Teams packages depend on. It bundles an async HTTP client built on httpx with token and interceptor support, a type-safe event emitter for lifecycle management, local storage abstractions for key-value and list data, and logging helpers that integrate with Python's standard logging module.

The package is designed as a shared layer rather than a standalone tool—it is typically installed as a dependency of other Teams SDK packages rather than used directly. It provides the plumbing needed for async Teams applications: making authenticated requests, emitting and listening to application events, persisting simple state locally, and integrating structured logging. The API is straightforward and async-first, with both synchronous and asynchronous variants for storage operations.

Use it for:

- As a dependency of other Microsoft Teams SDK packages to provide HTTP client and event infrastructure.
- Building async applications that need type-safe event handling for lifecycle events and message processing.
- Storing application state or configuration locally using the key-value or list storage abstractions.
- Centralizing logging configuration across an application using the provided logging helpers and filters.

## Worth the install?

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

Provides shared utilities for Microsoft Teams SDK packages, including an async HTTP client with token support, type-safe event emitter, local storage implementations, and logging helpers.

Yes. The package is actively maintained, has no known vulnerabilities, carries a permissive MIT license, and installs with minimal friction. It is most valuable as a dependency of other Teams SDK packages, but can also be used directly for async HTTP requests via httpx, event handling, and local storage. Requires Python 3.11 or later.

## Install

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

## Installing microsoft-teams-common

Before you install: Active maintenance with a recent release (10 days old) and no known vulnerabilities. Low install friction with a single runtime dependency (httpx). Requires Python 3.11 or later.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it safe for commercial and open-source projects.

Quickstart:

pip install microsoft-teams-common

from microsoft_teams.common import Client, ClientOptions

client = Client(ClientOptions(base_url="https://api.example.com"))
response = await client.get("/users/me")

Requires Python 3.11 or later; async operations require an async runtime context.

Verify before relying:

- Whether the HTTP client's token support covers common authentication schemes (OAuth2, Bearer tokens, etc.)
- Performance characteristics and limits of the local storage implementations for production workloads
- Compatibility expectations with other Teams SDK packages and their versions

## 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 sdk utilities, async http client with interceptors, type-safe event emitter, local key-value storage, teams bot common library, async-http, event-emitter, shared-utilities

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