Markdownify MCP vs Filesystem (Reference)

A side-by-side comparison of two Files & Storage servers — tools, transport, auth, maintenance, and copy-paste config for each.

	Markdownify MCP Convert PDFs, Office docs, images, audio, and web pages into Markdown for LLM consumption. Verified stdio (local) No auth Stale TypeScript	Filesystem (Reference) Official MCP reference server for secure local filesystem read/write within allowed directories. Verified stdio (local) No auth TypeScript
Category	Files & Storage	Files & Storage
Language	TypeScript	TypeScript
Transport	stdio (local)	stdio (local)
Auth	None	None
GitHub stars	2.6k	74k
Last commit	6 months ago	5 months ago
Verified
Actively maintained
Install	`git clone https://github.com/zcaceres/markdownify-mcp && cd markdownify-mcp && pnpm install && pnpm run build`	`npx -y @modelcontextprotocol/server-filesystem /absolute/path/to/dir`
Repo	Open	Open

Verdict

Pick Markdownify MCP if you prefer its approach (convert pdfs, office docs, images, audio, and web pages into markdown for llm consumption).

Pick Filesystem (Reference) if you want the official, vendor-maintained server, and you prefer the more popular, battle-tested option.

Add Markdownify MCP

Install / run

git clone https://github.com/zcaceres/markdownify-mcp && cd markdownify-mcp && pnpm install && pnpm run build

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

{
  "mcpServers": {
    "markdownify-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/markdownify-mcp/dist/index.js"
      ]
    }
  }
}

Add Filesystem (Reference)

Install / run

npx -y @modelcontextprotocol/server-filesystem /absolute/path/to/dir

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

{
  "mcpServers": {
    "filesystem-reference": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/absolute/path/to/dir"
      ]
    }
  }
}

FAQ

Markdownify MCP or Filesystem (Reference) — which is better?

Pick Markdownify MCP if you prefer its approach (convert pdfs, office docs, images, audio, and web pages into markdown for llm consumption). Pick Filesystem (Reference) if you want the official, vendor-maintained server, and you prefer the more popular, battle-tested option.

Can I use both Markdownify MCP and Filesystem (Reference)?

Yes — MCP clients let you enable multiple servers at once. Add both configs to your client's mcpServers and use whichever tool fits the task.

Do Markdownify MCP and Filesystem (Reference) work with Claude, Cursor and Windsurf?

Both do. Copy the per-client config below into Claude Desktop, Cursor, or Windsurf.

View Markdownify MCP →View Filesystem (Reference) →More comparisons →