Facthouse MCP Server

Facthouse is a local memory engine for AI tools. Most “memory” products index chat logs. Facthouse takes agent activity - messages, tool use, and other MCP traffic - and applies neuroscience-inspired consolidation so it moves through Data (what happened in the session) → Information (extracted facts) → Knowledge (integrated beliefs on an entity graph). During this process, Facthouse links entities, drops duplicates…. Its 8 documented tools cluster into read & search, log, consolidate.

People who work with ai memory, sqlite and knowledge engine and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-18 · ★ 2 · #91 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Facthouse

before you install - you'll need

Set FACTHOUSE_DATA, FACTHOUSE_STORAGE, FACTHOUSE_POSTGRES_URL before connecting.

Claude Code

claude mcp add gordonkjlee-facthouse -- npx -y @facthouse/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "gordonkjlee-facthouse": {
      "command": "npx",
      "args": [
        "-y",
        "@facthouse/mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @facthouse/mcp - the @facthouse scope differs from the repo owner (gordonkjlee); confirm it's the project's official package

registry namespace io.github.gordonkjlee is GitHub-verified and matches the repo owner

03 · What Facthouse can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can log conversation events (messages, artifacts), and retrieve events from current or previous session.

Capability map

Tools grouped from the project's README - what Facthouse lets an agent do.

read & search

6 tools - e.g. Retrieve events from current or previous session.; Working briefing (the same markdown as memory://briefing) plus facts captured in this session. Call at the start of every conversation if the client does…

get_events · get_session_context · get_context · search_knowledge · get_schemas · get_stats

Log

1 tool - e.g. Log conversation events (messages, artifacts).

log_event

Consolidate

1 tool - e.g. Integrate pending facts into long-term knowledge. Extracts entities, resolves duplicates, detects contradictions, builds the knowledge graph.

consolidate

Latest releases

v0.31.0 · 2026-09-10

0.31.0 (2026-09-10) · print MCP snippet before extract · walk up to a project .facthouse store · Windows capture tests were load detectors · honest historic extract, progress, Ctrl+C · name MCP config files on the init…

v0.30.0 · 2026-09-06

0.30.0 (2026-09-06) · replace mascot with constellation house · drop TTY residue on init --web and offer historic after it

v0.29.1 · 2026-09-05

0.29.1 (2026-09-05) · shorten MCP Registry description to 100-char max

04 · Who maintains Facthouse

Facthouse is maintained by gordonkjlee. We track 2 MCP servers from gordonkjlee - 2 actively maintained, 4 combined GitHub stars, oldest repo from Mar 2026.

05 · Facts

category
memory - ranked #91 of 304 actively-maintained memory servers as of 2026-09-18.
release cadence
10+ releases in the last 90 days (latest 2026-09-10)
registry
io.github.gordonkjlee/facthouse (active, first published 2026-09-04 · 6 versions)
packages
npm:@facthouse/mcp

06 · Facthouse FAQ

Is Facthouse still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-18 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Facthouse do?

With this server connected, an agent can log conversation events (messages, artifacts), and retrieve events from current or previous session.

How do I install Facthouse?

Run `npx -y @facthouse/mcp`. The README documents 3 environment variables (FACTHOUSE_DATA, FACTHOUSE_STORAGE, FACTHOUSE_POSTGRES_URL) to set first. Set FACTHOUSE_DATA, FACTHOUSE_STORAGE, FACTHOUSE_POSTGRES_URL before connecting. You can also paste the ready-made client config above.

Does Facthouse run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Facthouse

Pairs well with

Servers that cover what Facthouse doesn't - only shown when the pairing reason fits the companion.

  1. Server Filesystem → filesystem companion filesystem · ★ 39,038
  2. Pdf MCP → filesystem companion filesystem · ★ 135

More memory MCP servers · Gossipcat · Memxus · Epitome · Pathmark · Product CLI

More TypeScript MCP servers · SODAX Builders MCP · Bastion (gowthaman90) · Blacksmith · see all