squatch-codebook-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@squatch-codebook-mcp find notes related to transformers in ~/notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
squatch-codebook-mcp
Reason over your own local notes with a hyperdimensional (FHRR) codebook — query,
related, neighbors, walk, analogy. No LLM in the loop, nothing leaves your machine.
An MCP server, so it works in Claude Desktop (Chat) and Claude Code.
Run it (zero install — uvx fetches + runs)
uvx --from git+https://github.com/squatch-c-c/squatch-codebook-mcp squatch-codebook-mcpRequires uv (curl -LsSf https://astral.sh/uv/install.sh | sh).
Related MCP server: MCP Associative Memory Server
Add to Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"codebook": { "command": "uvx", "args": ["--from", "git+https://github.com/squatch-c-c/squatch-codebook-mcp", "squatch-codebook-mcp"] }
}
}Restart Claude. Now in Chat or Code you can ask things like "use codebook to find notes in ~/notes related to hyperdimensional computing" and it answers geometrically over your local files.
Tools
Tool | What it does |
| Index a folder; list its notes (run first). |
| Notes most related to a phrase. |
| Related notes (geometric + link recall). |
| Nearest notes by cosine similarity. |
| Reasoning walk along the LINKS relation. |
|
|
All paths are local; every tool reads only the directory you point it at. Part of the Squatch working system.
Available Tools
6 toolscodebook_analogyC
Analogy a:b :: c:? over your notes (VSA transform), returns the best completions.
Inputs: notes_dir (required), a (required), b (required), c (required), +2 more. Returns: result
codebook_buildA
Index a local notes folder and return its codebook contents (id + title per note). Run this first to see what's in a directory. notes_dir is a local path; glob picks files.
Inputs: notes_dir (required), glob.
codebook_neighborsC
Nearest notes to a given note by pure cosine similarity in the hypervector space.
Inputs: notes_dir (required), note_id (required), glob, k. Returns: result
codebook_queryB
Find the notes most related to a phrase, geometrically (no keyword match, no LLM).
Inputs: notes_dir (required), text (required), glob, k. Returns: result
codebook_walkB
Reasoning walk: from a note, repeatedly predict the next via the LINKS relation.
Inputs: notes_dir (required), start_id (required), glob, steps. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: indexing, analogy, nearest neighbors, query by phrase, related notes, and reasoning walk. No overlap or ambiguity.
All tools follow a consistent pattern: 'codebook_' prefix followed by a descriptive noun (analogy, build, neighbors, query, related, walk). No mixing of styles.
With 6 tools, the server is well-scoped for its purpose of note indexing and geometric reasoning. Not too few or too many.
Covers indexing, various retrieval methods, analogy, and reasoning. Minor gap: no incremental note addition or update; only reindexing entire folders, which could be a limitation.
Related MCP Connectors
Turn your notes, links and conversations into a Living Brain your AI tools share and build on.
Personal wiki and memory layer for AI assistants. Persistent, structured memory across sessions.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
A self-improving memory layer. Your memory, notes, tasks and goals, remembered everywhere.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables indexing and retrieving notes with full-text search using SQLite, plus building knowledge graphs to find relationships between concepts. Supports natural language note management, tagging, and semantic connections.16-
- AlicenseNot gradedqualityDmaintenanceEnables storing, searching, and discovering knowledge connections using associative memory, with semantic search, hierarchical organization, and cross-environment sync.13 PyPI1MIT
- AlicenseAqualityDmaintenanceEnables semantic search over local markdown note collections using vector embeddings, with real-time file watching and zero-config setup.4MIT
- AlicenseAqualityDmaintenanceTurns a local folder of notes and documents into a searchable knowledge base for AI assistants via MCP, enabling semantic search, reading, and adding notes entirely on-device.49MIT