Home Memory

v1.0.0Knowledge & Memorystable

MCP server that lets your AI assistant remember everything about your home.

buildingclaudecsharpdotnetfirebird
Share:
75
Stars
0
Downloads
0
Weekly
0/5

What is Home Memory?

Home Memory is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that lets your ai assistant remember everything about your home.

MCP server that lets your AI assistant remember everything about your home.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server that lets your AI assistant remember everything a

Use Cases

Enable AI assistants to remember details about your home.
Track home inventory, documentation, and building information.
impactjo

Maintainer

LicenseAGPL-3.0
Languagec#
Versionv1.0.0
UpdatedMay 15, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx home-memory

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Home Memory

Home Memory is a C#/.NET MCP server that gives AI assistants a persistent, structured knowledge base of everything in your home — rooms, floors, devices, furniture, fixtures, cables, pipes, and more. It stores all data in a single local Firebird database file with no cloud sync, and exposes 24 MCP tools covering full CRUD operations across all element types, physical connection tracking for infrastructure like electrical and plumbing, and over 100 built-in editable categories. On first launch it auto-creates a sample house structure and category set so the AI can start answering questions about your home immediately.

Prerequisites

  • Windows, macOS, or Linux (cross-platform .NET runtime)
  • The HomeMemoryMCP executable downloaded from the GitHub releases page
  • An MCP-compatible client such as Claude Desktop, Claude Code, or OpenAI Codex
  • Optional: custom HOME_MEMORY_DB_PATH to store the database in a specific location
1

Download the HomeMemoryMCP executable

Go to the GitHub releases page at https://github.com/impactjo/home-memory/releases and download the latest release for your platform (Windows, macOS, or Linux). Extract it to a permanent location such as C:\HomeMemory\ on Windows.

2

Configure Claude Desktop to use Home Memory

Add the server entry to your claude_desktop_config.json pointing at the downloaded executable. No additional arguments are required for basic usage.

{
  "mcpServers": {
    "home-memory": {
      "command": "C:\\HomeMemory\\HomeMemoryMCP.exe"
    }
  }
}
3

Or add via Claude Code CLI

Use the claude mcp add command to register the server at user scope, so it is available across all projects.

claude mcp add home-memory --scope user -- "C:\HomeMemory\HomeMemoryMCP.exe"
4

Set optional environment variables

Override the default database location with HOME_MEMORY_DB_PATH if you want the database stored in a specific directory. HOME_MEMORY_FBCLIENT can point to a custom Firebird client library if the bundled one is not suitable.

{
  "mcpServers": {
    "home-memory": {
      "command": "C:\\HomeMemory\\HomeMemoryMCP.exe",
      "env": {
        "HOME_MEMORY_DB_PATH": "D:\\MyData\\home-memory.fdb"
      }
    }
  }
}
5

Restart your MCP client and explore your home

Restart Claude Desktop. On first run, Home Memory automatically creates 100+ categories and a sample house structure. Ask the AI to show you the structure of your home to confirm it is working.

Home Memory Examples

Client configuration

claude_desktop_config.json entry for Home Memory on Windows with optional custom database path.

{
  "mcpServers": {
    "home-memory": {
      "command": "C:\\HomeMemory\\HomeMemoryMCP.exe",
      "env": {
        "HOME_MEMORY_DB_PATH": "C:\\Users\\Me\\HomeMemory\\home.fdb"
      }
    }
  }
}

Prompts to try

Example prompts for building and querying your home knowledge base.

- "Show me the structure of my home."
- "I have a Bosch washing machine in the basement — add it to my inventory."
- "We're planning to install a heat pump in the utility room. Record it as a planned item."
- "What devices and appliances are in the kitchen?"
- "Document the electrical cable running from the breaker panel to the garage lights."
- "What's in the basement? Show me everything including planned items."

Troubleshooting Home Memory

Executable not found or permission denied on startup

Ensure the path in your MCP config uses double backslashes on Windows (C:\\HomeMemory\\HomeMemoryMCP.exe). On macOS/Linux, make the binary executable with chmod +x HomeMemoryMCP. Verify the file exists at the specified path.

Firebird database error on first launch

The bundled Firebird client library handles database creation automatically. If you see a client library error, set HOME_MEMORY_FBCLIENT to the path of a manually installed fbclient.dll (Windows) or libfbclient.so (Linux). Download Firebird from firebirdsql.org.

Database file grows too large over time

The local Firebird database stores all home data indefinitely. Use the delete element tools exposed by the MCP server to remove obsolete entries, or back up and recreate the database file at HOME_MEMORY_DB_PATH using the Firebird management tools.

Frequently Asked Questions about Home Memory

What is Home Memory?

Home Memory is a Model Context Protocol (MCP) server that mcp server that lets your ai assistant remember everything about your home. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Home Memory?

Follow the installation instructions on the Home Memory GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Home Memory?

Home Memory works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Home Memory free to use?

Yes, Home Memory is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "home-memory": { "command": "npx", "args": ["-y", "home-memory"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Home Memory?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides