to-markdownLABSCO SUMMARY
The spreadsheet coverage is the unusual part.
Alongside the expected PDF and image handling it accepts .numbers, .ods and the whole Excel family, which is the format range that usually forces a manual export step first. Files are sent to Cloudflare for conversion, so this is the wrong tool for documents that must not leave your machine — and the returned token count per file is worth reading before you paste a large batch into a conversation.
What it is
An MCP server that converts files into Markdown descriptions using Cloudflare AI's native tomarkdown API. It takes an array of file paths in one call and returns, per file, the filename, MIME type, the generated Markdown description and a token count — so batch conversion is a single tool call rather than one per document.
What you get
- Several files converted in one call, each answered with its filename, MIME type, description and token count — the
to-markdowntool, whose only required input isfilePaths - Documents:
.pdf - Images:
.jpeg,.jpg,.png,.webp,.svg - Web and data formats:
.html,.xml,.csv - Spreadsheets:
.xlsx,.xlsm,.xlsb,.xls,.et,.ods,.numbers
Requirements
A Cloudflare account: both CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID must be set, and conversion runs on Cloudflare's side rather than locally. Node.js 18 or later. The npm package has been withdrawn, so build it from the repository with npm install and npm run build, then point Cursor or Claude Desktop at dist/index.js with both Cloudflare variables in the config's env.
Setup effort
Build from source — git clone https://github.com/FradSer/mcp-server-to-markdown.git
USE CASES
01
Getting a stack of PDFs into a conversation
Pass every path in one call and get a Markdown description per file, with the token cost of each stated up front.
02
Reading a spreadsheet nobody can open
Convert .numbers, .ods or a legacy .xls without first re-exporting it in another application.
03
Describing images and diagrams for a document
Send the PNG, WebP or SVG files and get Markdown descriptions you can paste into the write-up.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- npm on PATH
- Node.js 18 or later
- CLOUDFLARE_API_TOKEN in your environment
- CLOUDFLARE_ACCOUNT_ID in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/FradSer/mcp-server-to-markdown.git
cd mcp-server-to-markdown
npm install
npm run buildMCP Clients
Cursor, Claude Desktop
JSON
{
"mcpServers": {
"to-markdown": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_SERVER_TO_MARKDOWN>/dist/index.js"
],
"env": {
"CLOUDFLARE_API_TOKEN": "<YOUR_CLOUDFLARE_API_TOKEN>",
"CLOUDFLARE_ACCOUNT_ID": "<YOUR_CLOUDFLARE_ACCOUNT_ID>"
}
}
}
}<YOUR_PATH_TO_MCP_SERVER_TO_MARKDOWN> is the absolute path to your clone.
