MCP.Market

Markdown Notes MCP server

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

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

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars54 downloads/wk

Reviews

Write one

Nobody has reviewed Markdown Notes yet.

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

Markdown Notes tools (4)

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.

Public scan report

scanner v0.1.10 · 2026-10-03 · 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 7 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.RubricAppeal a findingJSON

How Markdown Notes compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
4
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
54
more than 45% of 12,191 servers with a package

What its tools let an agent do: 3 read · 1 create

Install Markdown Notes in Claude Code, Cursor or VS Code

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
Add to Cursor

What the publisher says

From the Markdown Notes repository's README, as published. We do not edit it. Read it on GitHub

Suprasūtā Markdown Notes — MCP server

Let Claude, VS Code and Antigravity read any document on your machine — without uploading it.

Created by Narashiman Krishnamurthy

Licence: free for personal, non-commercial use. See LICENSE.md.

What it does

AI assistants can read plain text, and some can read PDFs. None of them read EPUB, OpenDocument, PowerPoint or a scanned image, and all of them do it by uploading your file to a server.

This converts documents on your own machine and hands back Markdown that has been tidied for a model to read — tables promoted to real Markdown tables, deep indentation flattened, code properly fenced.

Tools

About tokens

Converting costs you nothing — it all happens locally. But returning a long document into the conversation does cost tokens, at the same rate as pasting it in by hand.

So a long conversion is saved to disk and only a short preview comes back. A 50-page PDF costs roughly 400 tokens instead of 30,000. Short documents are returned in full, since they are cheap either way. Ask for return_content: "full" to override.

Installing

Claude Desktop — the easy way

Download the .mcpb file from Releases and double-click it. Claude Desktop installs it and asks which folders it may read, and optionally for API keys. No Node, no terminal, no JSON.

Claude Desktop — from source

npm install
npm run build
node scripts/install-claude-desktop.mjs --roots "D:\your\documents"

Then restart Claude Desktop completely. The script patches the existing config rather than replacing it, and writes a timestamped backup first.

--roots is optional but recommended: it limits which folders the server will read. Without it, any path the assistant asks for is allowed.

To remove it again: node scripts/install-claude-desktop.mjs --remove

From npm — any MCP host

npm install -g suprasuta-markdown-mcp

Then point your host at the suprasuta-markdown-mcp command, or run it without installing:

{
  "servers": {
    "suprasuta-markdown": {
      "command": "npx",
      "args": ["-y", "suprasuta-markdown-mcp"],
      "env": { "MARKDOWN_MCP_ROOTS": "D:\\your\\documents" }
    }
  }
}

VS Code and Antigravity

Both read a standard MCP configuration — the block above works as-is. Antigravity looks in ~/.gemini/config/mcpconfig.json, or .agents/mcpconfig.json inside a workspace.

To run a checkout rather than the published package, replace command and args with node and the absolute path to dist/server.js.

Optional cloud features

Both are dormant until a key is present. Everything else works without either.

Keys are read from the environment, never written to disk and never logged.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Markdown Notes: common questions

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, Cursor, VS Code or Claude Desktop 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 39 days ago (2026-09-26). The latest release is v0.1.4.
What can I use instead of Markdown Notes?
Servers from other publishers that do the same job: kordoc MCP server.
How does Markdown Notes compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Markdown Notes

Same job from other publishers: the closest match first, then the best rated.

  • kordoc
    Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX, PPTX) to Markdown; fill forms, diff, render.
    A