# Lumberroom

> Lumberroom is an open-source MCP server for knowledge and memory. One shared memory for Claude Code, ChatGPT and Claude.ai, with per-client grants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Starting price:** $8.99 a month
- **Platforms:** self-hosted, API
- **Website:** https://lumberroom.cloud
- **Repository:** https://github.com/lumberroom/lumberroom
- **MCP Registry name:** cloud.lumberroom/lumberroom
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

The problem Lumberroom targets is that each assistant keeps its own notes, so correcting one leaves the others with the old answer. It keeps one store of facts behind an MCP server, grouped into rooms such as global, user:me, a project, personal:finance or credentials:aws. Each client has a grant naming which rooms it may enter and how deep.

Filtering happens inside the SQL query, so a withheld row is never fetched into the client's process, and a struck tool does not appear in tools/list. The server re-checks the grant on every call. Clients authenticate with a bearer token or the built-in OAuth 2.1 flow with PKCE. The registry keeps one value per key with who confirmed it, and a correction retires the old value in the same transaction.

The engine is Apache-2.0 and can be self-hosted, or you can use the hosted version.

## Features

- **Rooms and grants:** A per-client grant decides which rooms it can enter and how far.
- **Server-side filtering:** Withheld rows never reach the client's process.
- **Hidden tools:** Tools a grant forbids are omitted from tools/list.
- **Correct once:** A registry keeps one confirmed value per key.
- **OAuth 2.1 or token:** Clients sign in with PKCE or a bearer header.
- **Self-host option:** Apache-2.0 engine, or hosted.

## Good for

- Share one set of facts across Claude Code, ChatGPT and Claude.ai
- Keep finance and credentials out of some clients' reach
- Correct a fact once instead of in every assistant
- Scope decisions to a single codebase

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http lumberroom https://mcp.lumberroom.cloud/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.lumberroom.cloud/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lumberroom": {
      "url": "https://mcp.lumberroom.cloud/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lumberroom": {
      "type": "http",
      "url": "https://mcp.lumberroom.cloud/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lumberroom": {
      "serverUrl": "https://mcp.lumberroom.cloud/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lumberroom": {
      "type": "http",
      "url": "https://mcp.lumberroom.cloud/mcp"
    }
  }
}
```

## Tools

- `context_bootstrap`: Available to any grant.
- `memory_search`: Searches memories.
- `memory_write`: Writes a memory.
- `registry_get`: Reads a registry value.
- `alias_list`: Lists aliases.
- `review_queue`: Shows the review queue.
- `review_decide`: Decides a review item.
- `memory_history`: Reads memory history; needs mayReadHistory.
- `registry_history`: Reads registry history; needs mayReadHistory.
- `registry_set`: Sets a registry value; needs registryWrite.
- `alias_set`: Sets an alias; needs registryWrite.
- `memory_forget`: Deletes a memory; needs mayDelete.

## FAQ

### Is it open source?

The site says the engine is Apache-2.0 and can be self-hosted.

### What does hosting cost?

Free holds 1,000 memories; Solo is $8.99 a month with no cap and is free during the beta.

### Does a client learn about rooms it cannot enter?

No. Rooms outside its grant are not named to it.

### Is Lumberroom free?

Yes. Lumberroom is open source, so you can use and self-host it for free.

### How do I add Lumberroom to Claude Code?

Run this command in your terminal: claude mcp add --transport http lumberroom https://mcp.lumberroom.cloud/mcp

### What are the best alternatives to Lumberroom?

The closest alternatives to Lumberroom are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/lumberroom
