Oremi Iṣakoso

Oremi Iṣakoso is an MCP server for smart home control. It exposes Zigbee2MQTT devices through the Model Context Protocol (MCP), enabling AI assistants and autonomous agents to discover, monitor, and control connected devices using a standardized interface.

Built with FastAPI and designed to run in Docker, Oremi Iṣakoso provides secure, reliable, and real-time access to lights, switches, sensors, plugs, thermostats, and other Zigbee devices without requiring agents to interact directly with Zigbee2MQTT.

The name Oremi Iṣakoso comes from the Yoruba language. Oremi means "my friend", reflecting the project's goal of building a helpful and trustworthy AI ecosystem. Iṣakoso means "control" or "management", representing the service's responsibility for managing and controlling smart home devices through a unified MCP interface.

Documentation

All project documentation—including architecture details, configuration reference, and the Home Assistant integration guide—can be found at: https://demsking.gitlab.io/oremi-isakoso/

Development

Oremi Iṣakoso is built with Python and uses uv for dependency management. The project follows standard Python development practices with type hints, linting, and automated testing.

For detailed information on setting up your development environment, running tests, code style guidelines, and the pull request process, please refer to CONTRIBUTING.md.

Versioning

This project adheres to Semantic Versioning (SemVer). Version numbers follow the MAJOR.MINOR.PATCH format:

• MAJOR version increments for incompatible API changes
• MINOR version increments for backward-compatible new functionality
• PATCH version increments for backward-compatible bug fixes

License

Copyright 2026 Sébastien Demanou. All Rights Reserved.

Licensed under the Apache License, Version 2.0. See the LICENSE for the complete license text.