# file2markdown

> file2markdown is a freemium MCP server for files and documents. Convert PDFs, Office files, scans and web pages to Markdown inside Claude or Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://www.file2markdown.ai/mcp
- **Repository:** https://github.com/robinhill85/file2markdown-mcp
- **MCP Registry name:** ai.file2markdown/file2markdown
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.file2markdown.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "file2markdown": {
      "url": "https://mcp.file2markdown.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/file2markdown
