python-matter-server

What it is and what it does

Python-matter-server is an officially certified Matter controller implementation that runs as a WebSocket server, allowing applications to discover, communicate with, and control Matter-enabled smart home devices. It wraps the official Matter SDK and provides both server and client interfaces, making it suitable for integration into home automation platforms or standalone projects.

The package depends on aiohttp for async HTTP/WebSocket handling, aiorun for async runtime management, coloredlogs for formatted logging, orjson for efficient JSON serialization, and home-assistant-chip-clusters for Matter cluster definitions. The project is currently in maintenance mode—critical bugs will be addressed, but new features are being developed in a separate rewrite, so this package is suitable for stable deployments but not for projects requiring active feature development.

Use it for:

• Integrate Matter device support into home automation platforms via a dedicated server component
• Build standalone Matter controller applications that discover and manage Matter devices over a local network
• Develop IoT gateways that bridge Matter devices to non-Matter systems through WebSocket APIs
• Test and validate Matter device implementations against a certified controller during device development
• Create custom home automation scripts that programmatically control Matter devices via async Python

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a WebSocket-based Matter controller server that implements the Matter protocol, enabling Matter device discovery, communication, and control for home automation systems.

Yes, with conditions. The package is production-stable and officially certified for Matter control, making it suitable for stable home automation deployments. However, install it only if you need a Matter controller now and can accept that new features will not be added—the project is in maintenance mode. If you require active feature development, monitor the replacement project for its alpha release. No known security vulnerabilities and low install friction make it a safe choice for existing integrations.

Install

python-matter-server on PyPI

pip install python-matter-server

uv add python-matter-server

poetry add python-matter-server

Installing python-matter-server

Before you install

Low install friction with a pure-Python wheel distribution. Maintenance status is aging (242 days since last release), and the project has entered maintenance mode with new development moving elsewhere; bug fixes will continue but new features are paused.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions, though you must retain license and copyright notices in any distributed copies.

Quickstart

pip install python-matter-server

import aiohttp
import aiorun
import orjson

# Server runs over WebSockets using aiohttp, aiorun, orjson, coloredlogs, and home-assistant-chip-clusters

Requires Python 3.12 or later.

Verify before relying

• Whether the package requires system-level Matter SDK libraries or if all dependencies are bundled
• Specific Matter device types supported and certification scope details
• Performance characteristics and scalability limits for concurrent device connections
• Migration path and timeline for projects when the matter.js replacement reaches stable release

Package facts

Evidence: python_matter_server-8.1.2-py3-none-any.whl

Tags

More Home Automation packages