# io.github.Narashiman-K/markdown-notes-mcp (npm · suprasuta-markdown-mcp) Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload. - Trust score: 67/100 (medium) - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-09-20 ## Components - npm · `suprasuta-markdown-mcp`: 67/100 (this document), [markdown](https://verifymcp.io/servers/narashiman-k-markdown-notes-mcp/suprasuta-markdown-mcp.md), [page](https://verifymcp.io/servers/narashiman-k-markdown-notes-mcp/suprasuta-markdown-mcp) ## Channel facts - Registry: `npm` - Package: `suprasuta-markdown-mcp` - Version: `0.1.4` - Transport: `stdio` ## Trust breakdown 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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-09-20. - **Supply Chain Security**: 98/100 - No malware found by supply-chain analysis. - A known CVE affects xlsx, but no fixed version has been published, so there is nothing to upgrade to. - No install/post-install scripts declared. - 73 of 194 dependencies flagged as unhealthy (1 deprecated). - **Provenance & Transparency**: 32/100 - Source repository is publicly reachable at the declared URL. - Provenance check failed: no build-provenance attestation is published. - License check failed: the license (SEE LICENSE IN LICENSE.md) isn't a recognized OSI-approved license. - Actively maintained (last published 4 days ago). - Disclosure check failed: no security disclosure policy was found in the source repository. - **Schema Quality & AI Usability**: 73/100 - AI-judged instruction clarity (excellent). - 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. - Usage-examples check failed: none of the tools include examples. - **Stability & Change Management**: 0/100 - Stability not yet verified: not enough scan history yet (needs a 30-day window). - **Tool Coverage**: 100/100 - 100% of tools have a non-trivial description (not blank, and not just the tool's name). - 100% of tool parameters carry a description. - **Tool Safety**: 100/100 - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured. - We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation. - An AI judge read all 4 captured unit(s) of tool text and found none that tries to manipulate the model reading it. - **Capabilities**: 100/100 - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28. **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. ## Install ### 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. ### Claude ```bash claude mcp add narashiman-k-markdown-notes-mcp -- npx -y suprasuta-markdown-mcp ``` ### Cursor ```json { "mcpServers": { "narashiman-k-markdown-notes-mcp": { "command": "npx", "args": [ "-y", "suprasuta-markdown-mcp" ] } } } ``` ### VS Code ```json { "servers": { "narashiman-k-markdown-notes-mcp": { "command": "npx", "args": [ "-y", "suprasuta-markdown-mcp" ] } } } ``` ### Codex ```bash codex mcp add narashiman-k-markdown-notes-mcp -- npx -y suprasuta-markdown-mcp ``` ### opencode ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "narashiman-k-markdown-notes-mcp": { "type": "local", "command": [ "npx", "-y", "suprasuta-markdown-mcp" ], "enabled": true } } } ``` ### OpenClaw ```bash openclaw mcp add narashiman-k-markdown-notes-mcp --command npx --arg -y --arg suprasuta-markdown-mcp ``` ### Hermes ```yaml mcp_servers: narashiman-k-markdown-notes-mcp: command: "npx" args: ["-y", "suprasuta-markdown-mcp"] ``` ### Netclaw ```json { "McpServers": { "narashiman-k-markdown-notes-mcp": { "Transport": "stdio", "Command": "npx", "Arguments": [ "-y", "suprasuta-markdown-mcp" ] } } } ``` ### Vellum ```bash assistant mcp add narashiman-k-markdown-notes-mcp -t stdio -c npx -a -y suprasuta-markdown-mcp ``` ### Other ```json { "mcpServers": { "narashiman-k-markdown-notes-mcp": { "command": "npx", "args": [ "-y", "suprasuta-markdown-mcp" ] } } } ``` ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-09-17 (score 67, +15) - [security improvement] Malware scan: unverified → pass ### 2026-09-16 (score 52) First indexed and scored. ## MCP tools (4) ### `convert_to_markdown` (~454 tokens) 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". Input parameters: - `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, required): 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. ### `convert_folder_to_markdown` (~69 tokens) 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. Input parameters: - `output_directory` (string, required): Absolute directory to write each .md file into. - `paths` (array, required): Absolute paths of the files to convert. ### `save_summary` (~161 tokens) 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. Input parameters: - `source_path` (string, required): Absolute path of the document being summarised — either the original file or the converted .md. The summary is written beside it. - `summary` (string, required): The summary, as Markdown. Headings and lists are fine. - `title` (string): Optional heading for the summary. Defaults to the document name. ### `list_supported_formats` (~36 tokens) List the file extensions this server can convert, and report which optional cloud features are configured. Call this if a conversion fails as unsupported. ## Diagnostics Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/narashiman-k-markdown-notes-mcp/suprasuta-markdown-mcp#diagnostics ## Score history - 2026-09-20: 67 - 2026-09-19: 67 - 2026-09-18: 67 - 2026-09-17: 67 - 2026-09-16: 52 ## Common questions ### 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. ## Links - npm package: https://www.npmjs.com/package/suprasuta-markdown-mcp - Socket report: https://socket.dev/npm/package/suprasuta-markdown-mcp - Repository: https://github.com/Narashiman-K/Markdown-Notes-MCP - Changelog RSS feed: https://verifymcp.io/servers/narashiman-k-markdown-notes-mcp/suprasuta-markdown-mcp.xml - Changelog JSON feed: https://verifymcp.io/servers/narashiman-k-markdown-notes-mcp/suprasuta-markdown-mcp.json - HTML version of this page: https://verifymcp.io/servers/narashiman-k-markdown-notes-mcp/suprasuta-markdown-mcp