mcp-casambi

a MCP server to control lights in your CASAMBI network without using APIs.

[!CAUTION] CASAMBI is a registered trademark of CASAMBI Technologies Oy. This software is an independent, unofficial project and is not affiliated with, supported, or endorsed by CASAMBI Technologies Oy in any capacity. The use of the name CASAMBI is for the sole purpose of identifying compatibility and does not imply any official relationship with the company.

Video demonstration

Coming soon.

Attribution

Thank you to the following libraries for making this project possible.

• FastMCP: FastMCP makes it easier to make Python MCP servers!
• lkempf: CASAMBI BT interface library

Installation

Locate your MCP config path here or check your MCP client settings.

Using Docker (recommended)

Coming soon, our Thala should be working on it soon

Run Directly via uvx

This is the easiest and quickest method. You need to install uv for this to work. <br> Add this to your MCP server configuration:

{
  "mcpServers": {
    "mcp-helvarnet":{
      "command": "uvx",
        "args": [
          "--python=3.10",
          "--from",
          "git+https://github.com/nkapila6/mcp-casambi",
          "mcp-casambi"
        ]
      }
  }
}

MCP Clients

The MCP server should work with any MCP client that supports tool calling. Has been tested on the below clients.

• Claude Desktop
• Cursor
• Goose
• Others? You try!

Contributing

Have ideas or want to improve this project? Issues, feature requests and pull requests are welcome!

License

This project is licensed under the GNU GPLv3 License.