Notes MCP server
Local markdown notes: ranked + semantic search, tags, todos, and a wiki-link knowledge graph.
1 stars192 downloads/wk
Reviews
Write oneNobody has reviewed Notes yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Notes tools (22, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
append_noteAppend content to a note (creating it if missing). Good for journals and logs.
broken_linksList wiki-links that point at notes which don't exist.
create_from_templatewrite actionCreate a note from a template, substituting {{date}}, {{time}}, {{title}}, and any extra vars.
create_notewrite actionCreate a new markdown note. Fails if it exists unless overwrite is true.
daily_noteOpen today's daily note (creating it if needed) and optionally append a timestamped entry.
delete_notewrite actionPermanently delete a note by name.
find_pathShortest wiki-link chain between two notes (BFS). Reports if none exists.
get_backlinksFind all notes that link to the given note via [[wiki-link]] syntax.
get_neighborsNotes within N hops of a note over the (undirected) wiki-link graph, depth/limit capped.
get_outlineReturn just the heading tree of a note — grasp a big note in a few tokens.
graph_overviewAggregate graph health: note/link/tag counts, top hubs, orphans, broken-link count.
list_notesList notes (newest first) with pagination and an optional tag filter.
list_tagsList every tag across the vault with note counts.
list_templatesList available note templates (from the templates directory).
list_todosAggregate `- [ ]` checkbox todos across all notes. Open items only unless includeDone.
move_noteRename or move a note and rewrite every [[wiki-link]] pointing at it across the vault.
read_noteRead a note by name. Optionally read just one heading's `section`, or a
related_notesRank other notes by shared wiki-links and shared tags with the given note.
rename_tagRename a tag across the whole vault — rewrites frontmatter tags and inline #hashtags.
search_notesRanked full-text search. Supports `fuzzy`, `prefix`, and a `field` filter
semantic_searchSearch notes by meaning using local embeddings (all-MiniLM-L6-v2, runs
unlinked_mentionsFind notes that mention this note's title as plain text but don't yet link to it
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan23 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 84 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Notes compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 80% of 3,470 Web search servers
- Tools
- 22
- the typical Web search server has 5
- Tools that change things
- 14%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 55% of 1,786 Web search servers
- Downloads a week
- 192
- more than 70% of 827 Web search servers with a package
What its tools let an agent do: 17 read · 2 create · 2 change · 1 delete
Install Notes in Claude Code, Cursor or VS Code
Runs npx -y @abhishekmcp/notes on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add notes -- npx -y @abhishekmcp/notes
What the publisher says
From the Notes repository's README, as published. We do not edit it. Read it on GitHub
🧰 mcp-suite
A collection of Model Context Protocol servers, built in TypeScript.
Each server lives in its own folder under servers/ and publishes to npm as an independent package, while sharing tooling through an npm workspace. Connect them to any MCP client — Claude Desktop, Claude Code, Cursor, and more.
Table of contents
- Servers
- Quickstart
- Install
- Connecting to a client
- Architecture & conventions
- Development
- Adding a new server
- Publishing
- Contributing
- License
Servers
More on the way: a Spotify controller, and others.
Quickstart
git clone https://github.com/Abhishekkumar2021/mcp-suite.git
cd mcp-suite
npm install # installs deps for every workspace
npm run build # builds every serverInstall
Every server ships through every common channel. For the Claude Code plugin, add the marketplace once — /plugin marketplace add Abhishekkumar2021/mcp-suite — then install per the table. See each server's README for full config.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Notes: common questions
- Is Notes MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Notes safety report
- How do I install Notes?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Notes need an API key?
- No secret keys are declared. It reads 3 settings from the environment.
- Is Notes maintained?
- The last commit was 122 days ago (2026-07-04). The latest release is v0.4.1.
- What can I use instead of Notes?
- Servers from other publishers that do the same job: Octocode MCP server, Crg MCP server and Shodh Memory MCP server. Compare all Notes alternatives.
- How does Notes compare with other Web search MCP servers?
- safety score 88/100 (higher than 80% of 3,470 Web search servers); tools 22 (the typical Web search server has 5); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Notes
Same job from other publishers: the closest match first, then the best rated.
- not reviewedEstablishedA
- CrgToken-efficient code review knowledge graph: semantic search and call-graph resolution.not reviewedEstablishedB
Shodh MemoryCognitive memory for AI agents — semantic search, Hebbian learning, knowledge graphs.not reviewedEstablishedC- CodeseekerGraph-powered code intelligence with semantic search and knowledge graph for AI assistantsnot reviewedGrowingC
- ArxivSearch arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.not reviewedWidely usedA