OpenHAB MCP Server

@tdeckers

About OpenHAB MCP Server

An MCP server for OpenHAB

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openhab-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "--rm",
        "-p",
        "8081:8000",
        "\\"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is OpenHAB MCP Server?

OpenHAB MCP Server is a Model Context Protocol (MCP) server that connects to a real openHAB instance via its REST API. It enables AI assistants like Claude and Cline to interact with your openHAB smart home system through natural language.

How to use OpenHAB MCP Server?

Run the server using the prebuilt Docker/Podman image from ghcr.io/tdeckers/openhab-mcp. Set the required environment variables OPENHAB_URL and OPENHAB_API_TOKEN (and optionally OPENHAB_USERNAME/OPENHAB_PASSWORD for basic auth). By default the server uses stdio; set MCP_MODE=remote to expose Streamable HTTP at /mcp and SSE at /sse. Configure Claude Desktop or Cline in VSCode by adding a JSON configuration entry that launches the container.

Key features of OpenHAB MCP Server

Manage items, things, rules, scripts, and links
Supports stdio, Streamable HTTP, and SSE transports
Provides MCP resources for listing items
Enables natural language control via AI assistants
Containerized deployment with a published image

Use cases of OpenHAB MCP Server

List all openHAB items in your system using a chat prompt
Update item states or create new items conversationally
Create, update, or delete things and their configurations
Run rules on demand and manage rule scripts
Clean up orphaned item-channel links

FAQ from OpenHAB MCP Server

What is required to run the OpenHAB MCP Server?

Python 3.7+ is required for local development, but the recommended deployment uses the prebuilt container image with Podman or Docker.

How do I authenticate with my openHAB instance?

Set the OPENHAB_URL and OPENHAB_API_TOKEN environment variables. If your openHAB uses basic authentication, additionally set OPENHAB_USERNAME and OPENHAB_PASSWORD.

What transport modes are supported?

The server supports stdio (default) and remote mode. In remote mode (MCP_MODE=remote), it exposes Streamable HTTP at http://HOST:PORT/mcp and SSE at http://HOST:PORT/sse.

How can I connect the server to Claude or Cline?

Add a JSON configuration entry to the Claude Desktop config file or the Cline mcp.json file that runs the container with the required environment variables. The README provides exact configuration examples for both.

What openHAB components can I manage?

You can manage items, things, rules, scripts, and item-channel links. The server provides tools for listing, creating, updating, deleting, and running these components.

Frequently asked questions

What is required to run the OpenHAB MCP Server?

Python 3.7+ is required for local development, but the recommended deployment uses the prebuilt container image with Podman or Docker.

How do I authenticate with my openHAB instance?

Set the `OPENHAB_URL` and `OPENHAB_API_TOKEN` environment variables. If your openHAB uses basic authentication, additionally set `OPENHAB_USERNAME` and `OPENHAB_PASSWORD`.

What transport modes are supported?

The server supports stdio (default) and remote mode. In remote mode (`MCP_MODE=remote`), it exposes Streamable HTTP at `http://HOST:PORT/mcp` and SSE at `http://HOST:PORT/sse`.

How can I connect the server to Claude or Cline?

Add a JSON configuration entry to the Claude Desktop config file or the Cline `mcp.json` file that runs the container with the required environment variables. The README provides exact configuration examples for both.

What openHAB components can I manage?

You can manage items, things, rules, scripts, and item-channel links. The server provides tools for listing, creating, updating, deleting, and running these components.

Comments

Basic information

More Other MCP servers

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K