Notes
NPM · @ABHISHEKMCP/NOTES · SCANNED SEP 20
Local markdown notes: ranked + semantic search, tags, todos, and a wiki-link knowledge graph.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 38 of 115 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to Abhishekkumar2021/mcp-suite). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 83 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability87
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1196 tokens (~52/item across 23 items; 22 tools + 1 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management87
- Stability observed for 26 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 23 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Notes MCP server?
Notes runs locally as an npm package, launched with npx -y @abhishekmcp/notes. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @abhishekmcp/notes
claude mcp add abhishekkumar2021-notes -- npx -y @abhishekmcp/notes
{
"mcpServers": {
"abhishekkumar2021-notes": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/notes"
]
}
}
} {
"servers": {
"abhishekkumar2021-notes": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/notes"
]
}
}
} codex mcp add abhishekkumar2021-notes -- npx -y @abhishekmcp/notes
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"abhishekkumar2021-notes": {
"type": "local",
"command": [
"npx",
"-y",
"@abhishekmcp/notes"
],
"enabled": true
}
}
} openclaw mcp add abhishekkumar2021-notes --command npx --arg -y --arg @abhishekmcp/notes
mcp_servers:
abhishekkumar2021-notes:
command: "npx"
args: ["-y", "@abhishekmcp/notes"] {
"McpServers": {
"abhishekkumar2021-notes": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@abhishekmcp/notes"
]
}
}
} assistant mcp add abhishekkumar2021-notes -t stdio -c npx -a -y @abhishekmcp/notes
{
"mcpServers": {
"abhishekkumar2021-notes": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/notes"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 −3
- Stability: pass → 0.80 functional
- 17 Sept 26 0
- Stability: 0.97 → pass security
- 16 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 −2
- Stability: pass → 0.83 functional
- 11 Sept 26 0
- Stability: 0.97 → pass security
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/@abhishekmcp/notes@0.4.1
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | Abhishekkumar2021/mcp-suite |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/Abhishekkumar2021/mcp-suite/.github/workflows/publish.yml@refs/tags/notes-v0.4.1 |
| Rekor log index | 1991084969 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:6f3b6f6bea7ef615112e00ff99cb41f8f1874a1db7417672f0ba58f352f37aba8158aa8710c6f64a87575f670aa4aa3b93052b16507a852389ade12ab |
Background: How many MCP packages publish verified provenance →
Dependencies 115 packages
| Packages resolved | 115 |
|---|---|
| Stale | 38 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
append_note Append to a note ~45
Append content to a note (creating it if missing). Good for journals and logs.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Markdown content to append |
| name | string | yes | Note name |
No output schema declared.
No examples provided.
broken_links Broken links ~19
List wiki-links that point at notes which don't exist.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
create_from_template Create note from template ~69
Create a note from a template, substituting {{date}}, {{time}}, {{title}}, and any extra vars.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Name for the new note |
| template | string | yes | Template name (see list_templates) |
| vars | object | – | Extra {{key}} substitutions |
No output schema declared.
No examples provided.
create_note Create a note ~70
Create a new markdown note. Fails if it exists unless overwrite is true.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Markdown content |
| name | string | yes | Note name, e.g. 'ideas' or 'projects/mcp' |
| overwrite | boolean | – | Overwrite if it already exists (default false) |
No output schema declared.
No examples provided.
daily_note Daily note ~64
Open today's daily note (creating it if needed) and optionally append a timestamped entry. Great for journaling and running logs.
| Name | Type | Req | Description |
|---|---|---|---|
| date | string | – | Target date YYYY-MM-DD (default today) |
| entry | string | – | Text to append as a timestamped bullet |
No output schema declared.
No examples provided.
delete_note Delete a note ~27
Permanently delete a note by name.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Note name to delete |
No output schema declared.
No examples provided.
find_path Find path ~43
Shortest wiki-link chain between two notes (BFS). Reports if none exists.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Start note |
| to | string | yes | End note |
No output schema declared.
No examples provided.
get_backlinks Get backlinks ~38
Find all notes that link to the given note via [[wiki-link]] syntax.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The note to find backlinks for |
No output schema declared.
No examples provided.
get_neighbors Get neighbors ~67
Notes within N hops of a note over the (undirected) wiki-link graph, depth/limit capped.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | integer | – | Hops to traverse (default 1) |
| limit | integer | – | Max neighbors (default 50) |
| name | string | yes | Center note |
No output schema declared.
No examples provided.
get_outline Get note outline ~35
Return just the heading tree of a note — grasp a big note in a few tokens.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Note name |
No output schema declared.
No examples provided.
graph_overview Graph overview ~28
Aggregate graph health: note/link/tag counts, top hubs, orphans, broken-link count.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_notes List notes ~76
List notes (newest first) with pagination and an optional tag filter. Returns name, title, size, tags, and whether more results remain.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results (default 50) |
| offset | integer | – | Start index (default 0) |
| tag | string | – | Only notes carrying this tag |
No output schema declared.
No examples provided.
list_tags List tags ~18
List every tag across the vault with note counts.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_templates List templates ~18
List available note templates (from the templates directory).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_todos List todos ~48
Aggregate `- [ ]` checkbox todos across all notes. Open items only unless includeDone.
| Name | Type | Req | Description |
|---|---|---|---|
| includeDone | boolean | – | Include completed `- [x]` items (default false) |
No output schema declared.
No examples provided.
move_note Move/rename a note ~48
Rename or move a note and rewrite every [[wiki-link]] pointing at it across the vault.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Current note name |
| to | string | yes | New note name/path |
No output schema declared.
No examples provided.
read_note Read a note ~102
Read a note by name. Optionally read just one heading's `section`, or a character window via `offset`/`limit` (sets a truncated flag when cut).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max characters to return |
| name | string | yes | Note name, e.g. 'ideas' or 'projects/mcp' |
| offset | integer | – | Character offset to start from |
| section | string | – | Read only the content under this heading |
No output schema declared.
No examples provided.
related_notes Related notes ~48
Rank other notes by shared wiki-links and shared tags with the given note.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results (default 10) |
| name | string | yes | Note to find relations for |
No output schema declared.
No examples provided.
rename_tag Rename a tag ~50
Rename a tag across the whole vault — rewrites frontmatter tags and inline #hashtags.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Existing tag (with or without #) |
| to | string | yes | New tag name |
No output schema declared.
No examples provided.
search_notes Search notes ~123
Ranked full-text search. Supports `fuzzy`, `prefix`, and a `field` filter (title/tag/body, or 'path' to match the note name). Returns ranked snippets.
| Name | Type | Req | Description |
|---|---|---|---|
| field | string | – | Restrict search to one field |
| fuzzy | boolean | – | Enable fuzzy matching (typo-tolerant) |
| limit | integer | – | Max results (default 10) |
| offset | integer | – | Start index (default 0) |
| prefix | boolean | – | Match term prefixes (default true) |
| query | string | yes | Search query |
No output schema declared.
No examples provided.
semantic_search Semantic search ~95
Search notes by meaning using local embeddings (all-MiniLM-L6-v2, runs offline after a one-time model download). Finds related notes even with no shared keywords. `hybrid` fuses this with keyword search for best results.
| Name | Type | Req | Description |
|---|---|---|---|
| hybrid | boolean | – | Fuse semantic + keyword ranking (default false) |
| limit | integer | – | Max results (default 10) |
| query | string | yes | Natural-language query |
No output schema declared.
No examples provided.
unlinked_mentions Unlinked mentions ~52
Find notes that mention this note's title as plain text but don't yet link to it with [[wiki-link]] syntax — candidates for linking.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | The note to find unlinked mentions of |
No output schema declared.
No examples provided.
What is the Notes MCP server?
Notes is an MCP server listed in the public MCP registry as io.github.Abhishekkumar2021/notes. Local markdown notes: ranked + semantic search, tags, todos, and a wiki-link knowledge graph. This page covers its npm package (@abhishekmcp/notes).
Is the Notes MCP server safe to use?
Notes scores 95 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Notes MCP server expose?
Notes exposes 22 tools: list_notes, read_note, get_outline, search_notes, list_tags, and 17 more. Their descriptions and schemas cost roughly 1,183 tokens of context every time the server is loaded.
Is the Notes MCP server still maintained?
Notes is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Notes MCP server under?
Notes declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.