claude-memory-fts

Long-term memory MCP server for Claude Code. Stores facts in a local SQLite database with FTS5 full-text search and BM25 ranking.

Features

• Persistent memory — facts survive across sessions via SQLite
• Full-text search — FTS5 with BM25 ranking for relevant results
• LIKE fallback — partial matches when FTS5 finds nothing
• Access tracking — tracks how often each memory is accessed
• Upsert — automatically updates existing facts instead of duplicating
• Categorized — organize memories by type (preference, decision, technical, project, workflow, personal, general)
• 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

# Or run directly
npx claude-memory-fts

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

Search memories by keyword using FTS5 full-text search with BM25 ranking.

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

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

How It Works

• Memories are stored in a SQLite database with WAL mode for fast writes
• FTS5 virtual table mirrors the main table via triggers for real-time full-text indexing
• Search uses BM25 ranking for relevance, with a LIKE fallback for partial matches
• Each search/list call tracks access count and last accessed timestamp
• Duplicate facts are upserted (category and timestamp updated, no new row created)

Development

git clone https://github.com/kurovu146/claude-memory-mcp.git
cd claude-memory-mcp
npm install
npm run build
node dist/index.js

License

MIT