MCP Server for OpenHAB

What is MCP Server for OpenHAB?

MCP Server for OpenHAB is a server that connects MCP with the OpenHAB REST API, enabling MCP to interact with OpenHAB items. It is intended for developers and users who want to integrate MCP-based tools with their local OpenHAB smart home instance.

How to use MCP Server for OpenHAB?

Create a .env file with OPENHAB_URL and OPENHAB_TOKEN, install dependencies with npm install, then build the project using npm run build. For development, run with npm run dev (auto-restart); for production, run the compiled server with npm start or similar.

Key features of MCP Server for OpenHAB

• Provides two MCP operations: getItemState and sendCommand
• Communicates with OpenHAB via its REST API
• Requires only URL and API token configuration
• Built with TypeScript for type safety
• Supports development mode with automatic restarts

Use cases of MCP Server for OpenHAB

• Retrieve the current state of any OpenHAB item from an MCP client
• Send commands to OpenHAB items (e.g., turn lights on/off)
• Automate smart home actions through MCP-integrated assistants or workflows
• Monitor item states for dashboards or alerts

FAQ from MCP Server for OpenHAB

What configuration is required?

You must create a .env file with OPENHAB_URL (your local OpenHAB instance URL) and OPENHAB_TOKEN (an API token from OpenHAB).

What MCP operations are available?

Two operations are implemented: getItemState (returns the current state of an item) and sendCommand (sends a command to an item).

What are the runtime requirements?

The server is written in TypeScript and requires Node.js with npm. Dependencies are installed via npm install, and the project must be built before production use.

How do I run this in development?

Use npm run dev to start the server with automatic restart on file changes. For production, first build with npm run build, then run the compiled output.

Where do I find the API token?

The OPENHAB_TOKEN must be generated in your OpenHAB instance’s REST API settings. The server uses it for authenticated requests to the OpenHAB REST API.