Markdown Notes MCP server

by Narashiman-K·io.github.Narashiman-K/markdown-notes-mcp·v0.1.4

Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload.

B83/100grade B

What users say

No reviews yet

Safety scan

B83/100

Adoption

Growing

0 stars157 downloads/wk

Reviews

Nobody has reviewed Markdown Notes yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

convert_folder_to_markdown
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.
convert_to_markdown
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 bin
list_supported_formats
List the file extensions this server can convert, and report which optional cloud features are configured. Call this if a conversion fails as unsupported.
save_summary
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 \u2014 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.

scanner v0.1.5 · 2026-09-19 · same rubric, same numbers if you re-run it

no findings

Code scan3 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 qualitystatic API keys via environment variables6/15
Maintenancelast push 4 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

Runs npx -y suprasuta-markdown-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add markdown-notes-mcp -- npx -y suprasuta-markdown-mcp

Is Markdown Notes MCP server safe?: Mostly: it is graded B (83/100). Read the Markdown Notes safety report
How do I install Markdown Notes?: It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Markdown Notes need an API key?: Yes. The registry entry asks for GEMINI_API_KEY, ASSEMBLYAI_API_KEY.
Is Markdown Notes maintained?: The last commit was 5 days ago (2026-09-16). The latest release is v0.1.4.

Local package. It runs on your machine, not through the gateway.

MARKDOWN_MCP_ROOTSSemicolon-separated folders the server may read. Omit to allow any path.
GEMINI_API_KEYsecretOptional. Enables cloud image recognition, which can also describe charts. Images are sent to Google only when cloud mode is chosen.
ASSEMBLYAI_API_KEYsecretOptional. Enables audio transcription, the only feature that cannot run locally.

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/narashiman-k-markdown-notes-mcp.svg)](https://mcp.market/server/narashiman-k-markdown-notes-mcp)