Skip to content
MCP server

doc2md-lite

Convert text PDFs and HTML pages to Markdown on your own machine, tables intact

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.2.2
Listing updated
3 days ago

About doc2md-lite

doc2md-lite is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

A narrow, offline converter from a small tool maker whose paid sibling handles more formats. This free version takes one text PDF or saved HTML file at a time and writes a Markdown file. PDF headings are guessed from font size and boldness; HTML keeps bold, italic, links and code blocks and drops scripts, styles, menus and footers.

The README is frank about what it skips. Scanned pages are left out and listed, Word files are not read, web pages are not downloaded (save them first), and two-column papers may mix their columns. An option finds tables that have no border lines.

Python 3.10 or newer on Windows, Mac or Linux, MIT licensed. A paid version on Gumroad adds Word files, folders, page ranges and RAG chunks, and an Apify version bills per file. The tool prints a one-line note about the paid version in a terminal; the quiet flag turns it off.

Install

Run in a terminal

claude mcp add doc2md-lite -- uvx doc2md-lite

Add to claude_desktop_config.json

{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "doc2md-lite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "doc2md-lite": {
      "command": "uvx",
      "args": [
        "doc2md-lite"
      ]
    }
  }
}

What it does

PDF to Markdown
Text PDFs become Markdown with headings and lists.
Real Markdown tables
Tables are kept as tables, with an option for borderless ones.
HTML cleanup
Navigation, scripts and footers are dropped from saved pages.
Runs offline
Files stay on your computer.
Scanned page report
Image-only pages are skipped and named.

Good for

  • Turn a report PDF into notes-ready Markdown
  • Clean a saved web page for an AI app
  • Prepare documents before chunking for search
  • Extract text and tables from a text PDF for an assistant

Pricing

Open source

MIT licensed; paid versions: $12 on Gumroad, $0.003 per file on Apify

Prices change. Check tidybytetools.github.io before you buy.

doc2md-lite FAQ

Does it read scanned PDFs?

No. Pages without a text layer are skipped and the tool says which ones.

Can it convert Word files?

Not the free version; the paid version does.

Does it upload my files?

No, it runs on your own computer.

What does the paid version cost?

The site lists $12 on Gumroad, or $0.003 per file on Apify.

Is doc2md-lite free?

Yes. doc2md-lite is open source, so you can use and self-host it for free.

How do I add doc2md-lite to Claude Code?

Run this command in your terminal: claude mcp add doc2md-lite -- uvx doc2md-lite

What are the best alternatives to doc2md-lite?

The closest alternatives to doc2md-lite are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to doc2md-lite

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media