io.github.Narashiman-K/markdown-notes-mcp
NPM · SUPRASUTA-MARKDOWN-MCP · SCANNED SEP 20
Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload.
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
- A known CVE affects xlsx, but no fixed version has been published, so there is nothing to upgrade to. View diagnostics → Partial
- No install/post-install scripts declared.Pass
- 73 of 194 dependencies flagged as unhealthy (1 deprecated). View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (SEE LICENSE IN LICENSE.md) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 4 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability73
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 720 tokens (~180/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
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
- We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 4 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
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
How do I install the io.github.Narashiman-K/markdown-notes-mcp server?
io.github.Narashiman-K/markdown-notes-mcp runs locally as an npm package, launched with npx -y suprasuta-markdown-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · suprasuta-markdown-mcp
claude mcp add narashiman-k-markdown-notes-mcp -- npx -y suprasuta-markdown-mcp
{
"mcpServers": {
"narashiman-k-markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
]
}
}
} {
"servers": {
"narashiman-k-markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
]
}
}
} codex mcp add narashiman-k-markdown-notes-mcp -- npx -y suprasuta-markdown-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"narashiman-k-markdown-notes-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"suprasuta-markdown-mcp"
],
"enabled": true
}
}
} openclaw mcp add narashiman-k-markdown-notes-mcp --command npx --arg -y --arg suprasuta-markdown-mcp
mcp_servers:
narashiman-k-markdown-notes-mcp:
command: "npx"
args: ["-y", "suprasuta-markdown-mcp"] {
"McpServers": {
"narashiman-k-markdown-notes-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"suprasuta-markdown-mcp"
]
}
}
} assistant mcp add narashiman-k-markdown-notes-mcp -t stdio -c npx -a -y suprasuta-markdown-mcp
{
"mcpServers": {
"narashiman-k-markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
]
}
}
} 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.
- 17 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 16 Sept 26 52
First indexed and scored.
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/suprasuta-markdown-mcp@0.1.4
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 2 findings
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-4r6h-8v6p-xvw6 | CVE-2023-30533 | high | CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H | no |
| GHSA-5pgg-2g8v-p4x9 | CVE-2024-22363 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | no |
Background: What a vulnerability scan can and cannot prove →
Dependencies 194 packages
| Packages resolved | 194 |
|---|---|
| Deprecated | 1 |
| Stale | 73 |
| 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 →
convert_folder_to_markdown ~69
Convert several documents at once and return a summary of what succeeded. Use when the user points at a set of files rather than one.
| Name | Type | Req | Description |
|---|---|---|---|
| output_directory | string | yes | Absolute directory to write each .md file into. |
| paths | array | yes | Absolute paths of the files to convert. |
No output schema declared.
No examples provided.
convert_to_markdown ~454
Convert a document on this machine to clean Markdown. Handles PDF, Word (.docx), Excel (.xlsx/.xls/.xlsm), PowerPoint (.pptx), OpenDocument text and spreadsheets (.odt/.ods), EPUB, CSV/TSV and plain text. Images are read with OCR, and audio is transcribed. Conversion happens locally and the file is not uploaded, except for the image and audio cases noted in ocr_mode. Prefer this over reading a binary file directly. The Markdown is SAVED AUTOMATICALLY beside the original, keeping the full original filename plus .md — report.pdf becomes report.pdf.md — so it is always clear which file it came from. The user does not need to ask for this. Short documents are also returned in full; long ones come back as a preview plus the saved path, to avoid filling the conversation with tens of thousands of words. If you need more of a long document than the preview shows, call this again with return_content "full".
| Name | Type | Req | Description |
|---|---|---|---|
| ocr_mode | string | – | For images only. "offline" (default) runs on this machine and uploads nothing. "cloud" sends the image to Google Gemini, which is more accurate and can describe charts, and requires GEMINI_API_KEY. |
| overwrite | boolean | – | Set true to replace an existing .md of the same name. Default false, in which case a numbered name is used instead so nothing is destroyed. |
| path | string | yes | Absolute path to the file to convert. |
| return_content | string | – | "auto" (default) returns the whole document if it is short, otherwise a preview and the saved path. "full" always returns everything — use only when the user genuinely needs the entire text in the co… |
| save | boolean | – | Set false to skip writing the .md file. Default true — the file is saved beside the original without needing to be asked for. |
| save_to | string | – | Absolute path to write the .md to, overriding the default of beside the original. |
No output schema declared.
No examples provided.
list_supported_formats ~36
List the file extensions this server can convert, and report which optional cloud features are configured. Call this if a conversion fails as unsupported.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
save_summary ~161
Save a summary you have written about a document, as a .md file beside it. Call this WITHOUT being asked whenever you summarise, outline or answer a broad question about a document you converted — the user wants the summary kept, not just shown once in the chat. Do not call it for narrow factual lookups, and never invent a summary in order to save one: pass the text you actually produced.
| Name | Type | Req | Description |
|---|---|---|---|
| source_path | string | yes | Absolute path of the document being summarised — either the original file or the converted .md. The summary is written beside it. |
| summary | string | yes | The summary, as Markdown. Headings and lists are fine. |
| title | string | – | Optional heading for the summary. Defaults to the document name. |
No output schema declared.
No examples provided.
What is the io.github.Narashiman-K/markdown-notes-mcp server?
io.github.Narashiman-K/markdown-notes-mcp is listed in the public MCP registry as io.github.Narashiman-K/markdown-notes-mcp. Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload. This page covers its npm package (suprasuta-markdown-mcp).
Is the io.github.Narashiman-K/markdown-notes-mcp server safe to use?
io.github.Narashiman-K/markdown-notes-mcp scores 67 out of 100 on VerifyMCP. We recorded 2 known advisories against it as of 20 September 2026. It declares no install or post-install scripts. 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 io.github.Narashiman-K/markdown-notes-mcp server expose?
io.github.Narashiman-K/markdown-notes-mcp exposes 4 tools: convert_to_markdown, convert_folder_to_markdown, save_summary, list_supported_formats. Their descriptions and schemas cost roughly 720 tokens of context every time the server is loaded.
Is the io.github.Narashiman-K/markdown-notes-mcp server still maintained?
io.github.Narashiman-K/markdown-notes-mcp 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.