Notes runs on your own machine — the client starts it, so there is no endpoint to ping. 196 installs a week from npm. Last commit 4 Jul 2026.
Local markdown notes: ranked + semantic search, tags, todos, and a wiki-link knowledge graph.
What the code does
We read the source, 6 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
const stored = path.join(trashDir, id, path.basename(abs));
for (const [key, val] of Object.entries(process.env)) {
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add notes -- npx -y @abhishekmcp/notes{
"mcpServers": {
"notes": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/notes"
]
}
}
}[mcp_servers.notes]
command = "npx"
args = ["-y", "@abhishekmcp/notes"]{
"mcpServers": {
"notes": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/notes"
]
}
}
}{
"servers": {
"notes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/notes"
]
}
}
}Optional settings from the registry entry, left out of the block above:
NOTES_DIR (Directory containing your markdown notes (defaults to ~/notes)), NOTES_READONLY (Set to 1 or true to disable all note-modifying tools), NOTES_MODEL_DIR (Where the semantic-search embedding model is cached).
Alternatives to Notes
same job, measured the same waySearch, read and grow a Karpathy-style LLM wiki of linked Markdown pages, with cited answers.
Encrypted Markdown notes and team knowledge base. Search, read and write notes in vaults you allow.
Self-hosted agent memory as a markdown vault: semantic and keyword search, wikilink graph, OAuth
Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.
Recall over your markdown notes: vector search plus your [[wikilinks]] as a graph, in SQLite.
Index source code into a local knowledge base, search with keyword + semantic + hybrid modes.
Local Markdown/Obsidian knowledge substrate for MCP agents with governed memory and hybrid search.
Search an Obsidian vault by tag, term and wikilink graph. Read-only, deterministic, no embeddings.
Notes — questions
Answers built from our own checks of this server.