How do I install Memory Fts?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Memory Fts need an API key?

The publisher lists these environment variables: MEMORY_DB_PATH.

What transport does Memory Fts use?

Memory Fts runs locally over stdio.

When was Memory Fts last checked?

Last checked 2026-11-09. Long-term memory for Claude Code with SQLite FTS5 search and BM25 ranking

Memory Fts MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

MEMORY_DB_PATH — Custom path to the SQLite database file (default: ~/.claude/memory.db)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1MEMORY_DB_PATH=<value> claude mcp add io.github.kurovu146-memory-fts -- npx -y claude-memory-fts@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.kurovu146-memory-fts": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "MEMORY_DB_PATH": "<value>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

claude-memory-fts

Long-term memory MCP server for Claude Code. Stores facts in a local SQLite database with hybrid search (FTS5 + semantic vector similarity) and automatic context injection.

Features

Hybrid search — FTS5 keyword search + semantic vector similarity, merged via Reciprocal Rank Fusion (RRF)
Semantic understanding — find memories by meaning, not just keywords (powered by all-MiniLM-L6-v2 embeddings)
Auto context injection — top 30 most important memories injected into every prompt via hook
Importance ranking — facts ranked by access frequency, recency decay, and category weight
Access tracking — tracks how often each memory is accessed
Upsert — automatically updates existing facts instead of duplicating
Categorized — organize by type: preference, decision, technical, project, workflow, personal, general
MCP Resources — exposes memory://context resource for session context
Zero config — works out of the box, stores data in ~/.claude/memory.db

Install

# Add to Claude Code
claude mcp add memory -- npx claude-memory-fts

# Auto-configure context injection hook (recommended)
npx claude-memory-fts --setup-hook

The --setup-hook command automatically:

Creates ~/.claude/scripts/memory-context.sh
Adds a UserPromptSubmit hook to ~/.claude/settings.json
Top 30 memories are injected into every prompt automatically

CLI Commands

Command	Description
`npx claude-memory-fts`	Start MCP server (used by Claude Code)
`npx claude-memory-fts --context`	Output top 30 facts (used by hook script)
`npx claude-memory-fts --setup-hook`	Auto-configure context injection hook

Configuration

Environment Variable	Default	Description
`MEMORY_DB_PATH`	`~/.claude/memory.db`	Path to the SQLite database file

Example with custom path:

claude mcp add memory -e MEMORY_DB_PATH=/path/to/my/memory.db -- npx claude-memory-fts

Tools

`memory_save`

Save a fact to long-term memory.

Parameter	Type	Required	Description
`fact`	string	yes	The information to remember
`category`	string	no	One of: `preference`, `decision`, `personal`, `technical`, `project`, `workflow`, `general`

`memory_search`

Hybrid search: runs FTS5 and semantic search in parallel, merges results with RRF. Falls back to LIKE for partial matches.

Parameter	Type	Required	Description
`keyword`	string	yes	Search keyword or phrase
`limit`	number	no	Max results (default: 10)

`memory_update`

Update a memory's content or category by ID.

Parameter	Type	Required	Description
`id`	number	yes	Memory ID
`fact`	string	no	New content (omit to keep current)
`category`	string	no	New category (omit to keep current)

`memory_list`

List all saved memories grouped by category.

Parameter	Type	Required	Description
`category`	string	no	Filter by category
`limit`	number	no	Max results (default: 50)

`memory_delete`

Delete a memory by ID.

Parameter	Type	Required	Description
`id`	number	yes	Memory ID

Resources

`memory://context`

MCP resource exposing top 30 facts ranked by importance score:

Access frequency — frequently accessed facts score higher (capped at 20 points)
Recency — recently updated facts score higher (10 points, decays over 90 days)
Category weight — preference/decision (3), workflow/technical (2), project/personal (1), general (0)

How It Works

Search Pipeline

FTS5 + BM25 and semantic vector similarity run in parallel
Results are merged and deduplicated using Reciprocal Rank Fusion (k=60)
Facts appearing in both lists get naturally boosted
If both return empty, falls back to LIKE substring matching
Access count is tracked on every search hit

Embeddings

Model: all-MiniLM-L6-v2 (384 dimensions, ~23MB)
Generated locally via @xenova/transformers — no API calls, no data leaves your machine
Embeddings are created on save and backfilled on server startup
Cosine similarity with 0.3 threshold to filter noise

Storage

SQLite with WAL mode for fast concurrent reads/writes
FTS5 virtual table synced via triggers for real-time full-text indexing
Embeddings stored as BLOB columns alongside facts

Development

git clone https://github.com/kurovu146/claude-memory-mcp.git
cd claude-memory-mcp
npm install
npm run build
npm test

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Memory Fts?

Does Memory Fts need an API key?

What transport does Memory Fts use?

When was Memory Fts last checked?

Documentation

claude-memory-fts

Features

Install

CLI Commands

Configuration

Tools

memory_save

memory_search

memory_update

memory_list

memory_delete

Resources

memory://context

How It Works

Search Pipeline

Embeddings

Storage

Development

License

`memory_save`

`memory_search`

`memory_update`

`memory_list`

`memory_delete`

`memory://context`