Markdown Notes MCP Server

by narashiman-k Your server? Claim it

local only

Markdown Notes MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 67 installs a week from npm. Last commit 26 Sep 2026.

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

Installs per day peak 136 · avg 10 · -44% w/w

a month agotoday

Installs / week

npm · suprasuta-markdown-mcp

Stars

0 open issues

26 Sep 2026

Last commit

5 releases in 90 days

custom licence

License

TypeScript

Nothing serious here today

Today is the operative word: we check Markdown Notes MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markdown-notes-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "suprasuta-markdown-mcp"
      ]
    }
  }
}

~/.codex/config.toml

[mcp_servers.markdown-notes-mcp]
command = "npx"
args = ["-y", "suprasuta-markdown-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "markdown-notes-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "suprasuta-markdown-mcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "markdown-notes-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "suprasuta-markdown-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: MARKDOWN_MCP_ROOTS (Semicolon-separated folders the server may read. Omit to allow any path), GEMINI_API_KEY (Optional. Enables cloud image recognition, which can also describe charts. Images are sent to Google only when cloud mode is chosen), ASSEMBLYAI_API_KEY (Optional. Enables audio transcription, the only feature that cannot run locally).

Alternatives to Markdown Notes MCP

same job, measured the same way

AnyToMarkdown

by granturismo

Convert PDF, Word, Excel, PowerPoint, e-mails and web pages to clean Markdown for LLMs.

answering

Document to Markdown (Tanod)

by tanod

Document to Markdown: convert Word, Excel, PowerPoint and PDF files to Markdown for an LLM.

1 tools answering

Word, Excel & PowerPoint to Markdown

by kriton-dev

Convert Word, Excel, PowerPoint, OpenDocument, EPUB and RTF files to Markdown for LLMs and RAG

answering

Convertica

by convertica

Convert PDF, Word, Excel, PowerPoint, EPUB, HEIC & images — 35+ tools from convertica.net

46 installs/wk local only

Doc_Conv — Document to Markdown

by nicklee002e

Convert PDF/Word/Excel/PowerPoint documents to Markdown, paid in USDC via x402.

122 installs/wk local only

PDF Toolkit

by tensormaster

Convert PDFs/images to Word, Excel, and Markdown. Split, merge, and watermark PDF files.

answering

Doc To Markdown

by pavel-tashev

PDF, Word, PowerPoint, Excel, HTML, EPUB to Markdown: OCR, page ranges, tables, RAG chunking

answering

Docalyze

by lunarperovskite

Read and analyze local documents (PDF, Excel, CSV, Word, PowerPoint, images). No API keys needed.

85 installs/wk local only

Markdown Notes MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Markdown Notes MCP?

Markdown Notes MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package suprasuta-markdown-mcp was installed 67 times last week.

How do I connect Markdown Notes MCP?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls suprasuta-markdown-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Markdown Notes MCP?

The npm package suprasuta-markdown-mcp was installed 67 times in the last week. Week over week that is -44%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Markdown Notes MCP open source?

No, and the distinction matters: it ships its own licence file rather than a standard open-source licence. That makes it source-available — you can read the code, but the terms are the author's own, not one of the recognised open-source licences. Read them before you build on it.