housekeeper-bee-mcp-server

Thomas-Leung-852/housekeeper-bee-mcp-server

3.1

If you are the rightful owner of housekeeper-bee-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Housekeeper Bee MCP Server is a Model Context Protocol server designed to manage and facilitate communication between different components in a system, ensuring efficient data handling and processing.

housekeeper-bee-mcp-server

Housekeeper Bee MCP Server (STDIO)

Introduction

The MCP Server extends the functionality of the web-based Housekeeper Bee Application, which is designed for structural and fixed information flows. Using LLM, users are allowed to manage their storage box records in a dynamic and unstructured manner. The LLM client enhanced the UI/UX and user satisfaction. In the "Demonstration Clips" section, we show you how to use different languages and simple syntax to manage the storage asset records.


Requirement


System Architecture

[1] "Local Remote" - Housekeeper Bee server app and admin server
[2] Image Source - https://hackteam.io
[3] All system components are in the same Wi-Fi network


Installation

npm install -y

Configuration

Open Claude Desktop confirguration file (claude_desktop_config.json) and add the following lines to the mcpServers section

The claude_desktop_config.json file for Claude Desktop is located in different paths depending on your operating system. For Windows, it's found in %APPDATA%\Claude\claude_desktop_config.json, and for macOS, it's in ~/Library/Application Support/Claude/claude_desktop_config.json.

To find the file:

  1. Windows: Open File Explorer and paste %APPDATA%\Claude\ into the address bar. You will find the claude_desktop_config.json file there.
    Or click the "Edit Config" in Claude Desktop to open the "Claude" folder in file explorer.


  1. The file is automatically created when you click "Edit Config" in the Claude Desktop settings, under the "Developer" section. or you can create it manully.

{
	"mcpServers": {
		"housekeeper bee mcp server": {
			"type": "stdio",
			"command": "%ProgramFiles%\\nodejs\\node.exe",
			"args": [
				" {YOUR\\PATH}\\housekeeperbee-mcp-server\\src\\index.js"
			],
			"env" :{
				"HOUSEKEEPER_BEE_USER_API_KEY":"{YOUR HOUSEKEEPER BEE API KEY}",				
        	    "HOUSEKEEPER_BEE_SERVER_URL":"{HOUSEKEEPER BEE server URL e.g. https://127.0.0.1:8443",
        		"HOUSEKEEPER_BEE_ADMIN_URL":"{HOUSEKEEPER BEE ADMIN server URL e.g. http://127.0.0.1:8088}",
				"HOUSEKEEPER_BEE_OUTPUT_FILE_PATH": "{local file folder - e.g. c:\\tmp\\ }",
			}
		}
	}
}

Sample


  1. Restart the Claude Desktop

Demonstation Clips

YouTube



vNetic workshop - 2025
Last Update: 2025/08/26 by Thomas Leung