Skip to content
MCP server

file2markdown

Convert PDFs, Office files, scans and web pages to Markdown inside Claude or Cursor

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.1.0
Listing updated
2 days ago

About file2markdown

file2markdown is a freemium MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.

Asking a model to retype a document risks paraphrased text and invented table cells. This server instead runs extraction engines and returns identical Markdown on every run, up to 200,000 characters per call, and it can handle files a model cannot open itself, such as DOCX, XLSX, PPTX and EPUB behind a URL.

Every conversion comes back with a quality field, an output-health check with coverage and flagged line ranges. It does not compare against the source. For PDFs you can pass quality_check set to ai, which sends selected excerpts of the converted text, never the source file, to TypeSafe for narrow yes-or-no checks.

Limits are stated honestly. Web pages convert from served HTML, so JavaScript-only content may be incomplete, and it is a converter rather than a crawler. Nothing is stored. Free use is five conversions a day per network, so shared or hosted-agent IPs may hit it sooner, and a Pro key unlocks batches, scanned-PDF OCR and larger files.

Install

Run in a terminal

claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.file2markdown.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "file2markdown": {
      "url": "https://mcp.file2markdown.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "file2markdown": {
      "type": "http",
      "url": "https://mcp.file2markdown.ai/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "file2markdown": {
      "serverUrl": "https://mcp.file2markdown.ai/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "file2markdown": {
      "type": "http",
      "url": "https://mcp.file2markdown.ai/mcp"
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

convert_url
Fetch a public URL and return Markdown
convert_base64
Convert file contents sent directly
convert_batch
Convert 2 to 10 documents in one call (Pro key)
list_supported_formats
Formats, limits and what needs Pro
usage_status
Your tier and remaining conversions today

What it does

URL conversion
convert_url fetches a public page or document and returns Markdown.
Direct file input
convert_base64 converts file contents sent by a programmatic client.
Batch of up to 10
convert_batch handles 2 to 10 mixed items with per-item errors; needs a Pro key.
Quality check
Each result includes an output-health report with coverage and flagged lines.
OCR on Pro
Scanned PDFs and JPG/PNG images are read with OCR on the paid tier.
Output cap
Results are capped at 200k characters and marked truncated when cut.

Good for

  • Feed a long PDF into a chat as clean Markdown
  • Extract tables from an XLSX or DOCX without losing cells
  • Turn a set of reports into Markdown in one batch call
  • Check how many free conversions remain today

Pricing

Freemium

Free: 5 conversions a day, no account; Pro adds unlimited conversions, OCR and batches (price not published)

Prices change. Check file2markdown.ai before you buy.

file2markdown FAQ

Does it need an account?

Not for the free tier; add a Pro key as an Authorization bearer header to unlock more.

What are the free limits?

5 conversions a day per network, files up to 25MB, one at a time.

Which formats work?

PDF, DOCX, PPTX, XLSX/XLS, CSV, JSON, XML, HTML, EPUB, JPG/PNG, WAV/MP3 and ZIP are listed.

Are my files kept?

The README says files are converted and discarded and logs hold no URLs or content.

Does it render JavaScript?

No, so SPA-style pages may convert incompletely.

Is file2markdown free?

file2markdown has a free plan, with paid plans for more usage or features.

How do I add file2markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp

What are the best alternatives to file2markdown?

The closest alternatives to file2markdown are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to file2markdown

  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