raphasouthall avatar

NeuroStack

raphasouthall/neurostack

Connects Claude (or any MCP client) to your Markdown vaults with tiered search that goes from keyword matching to semantic embeddings and GraphRAG connections. Runs locally via Ollama or cloud via their hosted endpoint. The 24 exposed tools include read-only operations for search, graph analysis, and stale note detection, plus four opt-in git-backed write tools (vault_write_file, vault_delete_file, vault_read_file, vault_list_files) that commit every change with descriptive messages. Useful when you want your AI to remember context across sessions without re-pasting notes, or when you need it to catch deprecated information before citing it. Works with Obsidian folders, Logseq, Notion exports, or any collection of .md files.

GitHub stars
43
tools
5
transport
STDIO, HTTP
env var
1
last updated
Mar 31, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

vault_write_fileOpt-in MCP write tool that writes a note to the vault and commits and pushes the change to the git remote.

Opt-in MCP write tool that writes a note to the vault and commits and pushes the change to the git remote.

No parameter schema in public metadata yet.

vault_delete_fileOpt-in MCP write tool that deletes a note from the vault and commits and pushes the change to the git remote.

Opt-in MCP write tool that deletes a note from the vault and commits and pushes the change to the git remote.

No parameter schema in public metadata yet.

vault_read_fileReads a file from the vault.

Reads a file from the vault.

No parameter schema in public metadata yet.

vault_list_filesLists files in the vault.

Lists files in the vault.

No parameter schema in public metadata yet.

vault_rememberSaves a deliberate memory to the memory layer, stored as written and embedded once.

Saves a deliberate memory to the memory layer, stored as written and embedded once.

No parameter schema in public metadata yet.

Sponsors

Configuration

NEUROSTACK_VAULT_ROOT

Path to your Markdown vault (e.g. ~/brain, ~/notes)

Readme

NeuroStack

PyPI npm License CI MCP

A local retrieval layer and optimizer for the Markdown knowledge base you already have.


View the full README on GitHub

Details

Repository
github.com/raphasouthall/neurostack
Website
neurostack.sh
Categories
AI & LLM Tools, Documents & Knowledge, Search & Web Crawling
Package
neurostack
Transport
STDIO, HTTP
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1mybolide avatarMcp Probe Kitmybolide/mcp-probe-kitSpec-driven dev workflow MCP: start_* orchestration, memory, GitNexus, quality gates.41stars
2artkeyai avatarbhivedartkeyai/bhived-mcpShared memory for AI agents: query proven fixes, avoid known mistakes, and find skills and MCPs.35stars
3diaaaj avatarA Mem Mcpdiaaaj/a-mem-mcpSelf-evolving memory system for AI agents34stars
4oomkapwn avatarEnquire Mcpoomkapwn/enquire-mcpLong-term memory for AI agents — your Obsidian vault as searchable persistent memory.34stars
5selvage-lab avatarSelvageselvage-lab/selvageAn LLM-based code review MCP server with AST-powered smart context extraction33stars
6cyanheads avatarWorkflows Mcp Servercyanheads/workflows-mcp-serverStore, query, and create YAML workflow playbooks for LLM agents.32stars