mor

mor

[!WARNING] This is a personal project. I maintain it for my own use and share it because others might find it useful. Feature PRs are unlikely to be merged — if you have an idea, start a discussion first. Fork freely — it's MIT licensed.

AI-accessible knowledge you actually own. Plain markdown files on your disk, searchable by AI via MCP.

Your notes live on your disk as plain markdown with YAML frontmatter — readable without mor, portable to any tool, git-syncable across machines. The MCP server gives AI assistants (Claude Code, Claude Desktop, Cursor, etc.) persistent memory that survives context windows. You also get a CLI and HTTP API.

Install

npm install -g mor

Requires Node.js 20+.

Quick start

# Add notes
echo "Always use snake_case for Python variables" | mor add -t "Python naming"
mor add notes.md -t "Meeting notes" --tags "meeting,project-x"
mor add https://raw.githubusercontent.com/owner/repo/main/config.ts

# Search (FTS5 — tokenized, stemmed)
mor find python naming

# Grep (literal substring or regex)
mor grep snake_case
mor grep -i todo
mor grep -E "async\s+function"
mor grep -w Beer -n -C 2

# Read, edit, copy, remove
mor cat python naming
mor edit python naming
mor cp -o ./out.md python naming
mor rm python naming

# List
mor ls
mor ls -l

Commands

Command	Description
find <query>	Full-text search (--limit, -s threshold, --json)
grep <pattern>	Substring or regex search (-i, -E regex, -w word, -n line numbers, -l files only, -A/-B/-C context)
add [file|url]	Add from file, URL, stdin, or $EDITOR (-t title, -d description, --tags, --type)
cat <query>	Print content (--raw for frontmatter, --links for cross-references)
cp <query...>	Copy content to file (-o <dest>)
edit <query>	Open in $EDITOR (--raw to edit frontmatter)
update <query>	Update metadata or content (-t title, -d description, --tags, --type, --content-from)
patch <query>	Apply a str_replace patch to a note's content (--old, --new)
rm <query>	Remove a note
links [query]	Show cross-references for a note (--broken to find dangling links)
ls	List all (--limit, -l long, --tags, --types)
sync	Pull, commit, and push the notes folder via git
reindex	Rebuild search index
import <dir>	Import .md files from a directory
mcp	Start MCP server (stdio)
serve	Start HTTP server (-p port, -H host, --token, --mcp)
login	Authenticate with a remote server via OAuth (-s server URL)

Queries resolve in order: full UUID, UUID prefix (8+ chars), filename, FTS search. Multi-word queries don't need quoting — options go before the query: mor find --limit 5 python naming.

find, grep, and ls support shared filters: --type, --tag, --repo, --ext (all support glob patterns).

MCP server

Add to your Claude Code or Claude Desktop config:

{
  "mcpServers": {
    "mor": {
      "command": "mor",
      "args": ["mcp"]
    }
  }
}

Tools: notes_search, notes_read, notes_create, notes_update, notes_patch, notes_remove, notes_list, notes_grep.

To make sure Claude Code checks mor first when you ask it to recall something, add this to ~/.claude/CLAUDE.md:

## Notes