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. 136 installs a week from npm. Last commit 16 Sep 2026.

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

136

Installs / week

npm · suprasuta-markdown-mcp

Stars

0 open issues

16 Sep 2026

Last commit

0 releases in 90 days

—

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": {
      "args": [
        "-y",
        "suprasuta-markdown-mcp"
      ],
      "command": "npx"
    }
  }
}

~/.codex/config.toml

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

.cursor/mcp.json

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

.vscode/mcp.json

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

This one needs environment variables set before it will start: 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.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Markdown Notes MCP

same job, measured the same way

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.

77 installs/wk local only

Docalyze

by lunarperovskite

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

131 installs/wk local only

Convertisseur Ia

by walmes1

Documents (PDF, Word, Excel, PowerPoint, CSV) vers Markdown leger pour l'IA, 100 % local

32 installs/wk local only

Promptready MCP

by hydrojwh

Convert PDF/CSV to Markdown with AI-powered OCR via the PromptReady cloud API.

983 installs/wk local only

TruePath Office

by joytruepath

Local MCP for Word, Excel, PowerPoint & PDF on macOS — formulas, slides, DOCX, PDF ops. No network.

local only

OfficeAgent.NET

by ilia-sokolov

Create and edit Word, PowerPoint, and Excel files with typed plans and safe previews

local only

Csvto MCP

by bishop81

Local CSV, JSON and Excel conversion. Files are never uploaded and never enter the context.

60 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 136 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 with the file path 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 136 times in the last week. 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?

We cannot say either way: written in TypeScript and 0 stars on GitHub, but we could not determine the licence, and without one the code is not open source by default.