file2markdown
Convert docs and web pages to clean Markdown: PDF, DOCX, XLSX, EPUB, scans, URLs. Batch of 10.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http file2markdown 'https://mcp.file2markdown.ai/mcp' --header 'Authorization: <Optional Pro API key as '\''Bearer f2m_...'\'' — removes the daily limit and enables OCR. Free tier works without it.>'
{
"mcpServers": {
"file2markdown": {
"type": "http",
"url": "https://mcp.file2markdown.ai/mcp",
"headers": {
"Authorization": "<Optional Pro API key as 'Bearer f2m_...' — removes the daily limit and enables OCR. Free tier works without it.>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
file2markdown MCP server
Convert documents and web pages to clean, LLM-ready Markdown — from inside Claude, Cursor, or any MCP client.
Endpoint: https://mcp.file2markdown.ai/mcp (Streamable HTTP)
This is the official MCP server for file2markdown.ai. It gives agents deterministic document conversion as a tool: engine-extracted Markdown (no hallucinated table cells, no silent truncation), for anything reachable by URL — including formats assistants can't parse natively, like DOCX, XLSX, PPTX, EPUB, and scanned PDFs.
Tools
| Tool | What it does |
|---|---|
convert_url | Fetch a public URL (web page, PDF, Office doc, …) and return Markdown |
convert_base64 | Convert file contents directly (programmatic clients) |
convert_batch | 2-10 documents in one call, URLs and files mixed, per-item results (Pro API key) |
list_supported_formats | Formats, per-tier limits, and what needs Pro |
usage_status | Your tier and remaining conversions today |
Supported input formats: PDF, DOCX, PPTX, XLSX/XLS, CSV, JSON, XML, HTML, EPUB, JPG/PNG (OCR), WAV/MP3, ZIP.
Quick start
claude.ai — Settings → Connectors → Add custom connector → paste the endpoint URL. When asked about authentication choose None (this server uses API keys, not OAuth). Optional: add a request header Authorization: Bearer f2m_… with a Pro key.
Claude Code
claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp
Cursor / generic clients
{
"mcpServers": {
"file2markdown": { "url": "https://mcp.file2markdown.ai/mcp" }
}
}
Tiers
| Free (no key) | Pro API key | |
|---|---|---|
| Conversions | 5/day per network IP | Unlimited |
| Max download | 25MB | 100MB |
| Scanned-PDF OCR | — | Yes |
| Image OCR | — | Yes |
Pro keys are created on your account page and sent as Authorization: Bearer f2m_…. Plans: pricing.
Honest limits
- Web pages convert from served HTML — no JavaScript rendering, so SPA-style pages may convert incompletely. Near-empty results carry an explicit note (likely consent wall / paywall / JS shell).
- One URL at a time. This is a converter, not a crawler — no bulk scraping, public pages only.
- Output is capped at 200,000 characters (marked
truncated: truewhen hit). - Nothing is stored: files are converted and discarded; usage logging keeps no URLs or content.
Docs & source
- Setup guide: file2markdown.ai/mcp
- Facts page for AI assistants: file2markdown.ai/ai-info
- This repository contains the public documentation and the registry
server.json. The hosted service's application code is not open source.
Support
Email robin@file2markdown.ai.
Frequently asked questions
What is file2markdown?
Convert docs and web pages to clean Markdown: PDF, DOCX, XLSX, EPUB, scans, URLs. Batch of 10.
How do I install file2markdown?
It runs as a remote server. In Claude Code: claude mcp add --transport http file2markdown 'https://mcp.file2markdown.ai/mcp' --header 'Authorization: <Optional Pro API key as '\''Bearer f2m_...'\'' — removes the daily limit and enables OCR. Free tier works without it.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does file2markdown need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is file2markdown open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains file2markdown?
It is published by Robinhill85. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.