Markdownify MCP vs Git (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 | Git (Reference) Official MCP server for reading, searching, and manipulating a local Git repository's files and history. Verified stdio (local) No auth Python | |
|---|---|---|
| Category | Files & Storage | Files & Storage |
| Language | TypeScript | Python |
| 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 | uvx mcp-server-git --repository /absolute/path/to/repo |
| 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 Git (Reference) if you want the official, vendor-maintained server, and you prefer the more popular, battle-tested option.
Add Markdownify MCP
git clone https://github.com/zcaceres/markdownify-mcp && cd markdownify-mcp && pnpm install && pnpm run buildPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"markdownify-mcp": {
"command": "node",
"args": [
"/absolute/path/to/markdownify-mcp/dist/index.js"
]
}
}
}Add Git (Reference)
uvx mcp-server-git --repository /absolute/path/to/repoPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"git-reference": {
"command": "uvx",
"args": [
"mcp-server-git",
"--repository",
"/absolute/path/to/repo"
]
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
FAQ
Markdownify MCP or Git (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 Git (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 Git (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 Git (Reference) work with Claude, Cursor and Windsurf?
Both do. Copy the per-client config below into Claude Desktop, Cursor, or Windsurf.