flatmark — Claude Code MCP server: what it does, how to install
Converts PDF, Word, PowerPoint, Excel, and HTML files into clean Markdown through an MCP endpoint. Useful when your coding agent needs to read complex office docs or scanned pages.
claude mcp add --transport http markdown-converter https://api.flatmark.dev/mcp/What flatmark does
Small files up to 8 MB are processed directly in a single request using MarkItDown. When documents exceed this limit, flatmark routes files up to 25 MB or 200 pages into a Docling processing queue. That pipeline handles OCR extraction alongside table recognition, delivering Markdown plus structural JSON via signed webhooks or polling.
Hosting operates out of Germany. You can start without an account on the anonymous tier, though strict rate limits apply until you export a FLATMARK_API_KEY. The free plan includes 100 monthly credits without asking for payment card details.
What it helps with
- convert Excel sheets and tables into Markdown
- extract text from scanned PDF documents via OCR
- turn PowerPoint presentations into structured text
- feed HTML pages into agent context as clean Markdown
Example prompts for the agent
- Convert
specs.pdfto Markdown using flatmark. - Run OCR on
contract_scan.pdfand extract all tables as Markdown. - Turn
budget.xlsxinto a clean Markdown table.
How to install flatmark
Platform CLI: remote server
claude mcp add --transport http markdown-converter https://api.flatmark.dev/mcp/Platform CLI: remote server
codex mcp add flatmark --url https://api.flatmark.dev/mcp/Config file
{
"mcpServers": {
"flatmark": {
"url": "https://api.flatmark.dev/mcp/"
}
}
}Config file
{
"servers": {
"flatmark": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/"
}
}
}Platform CLI: remote server
gemini mcp add -t http flatmark https://api.flatmark.dev/mcp/Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about flatmark
How to install flatmark in Claude Code?
Run claude mcp add --transport http flatmark https://api.flatmark.dev/mcp/ in your terminal. This attaches the remote HTTP endpoint to your environment immediately.
What does flatmark do?
It transforms office files such as PDF, Word, Excel, and presentations into Markdown. Larger documents and image scans undergo OCR and table parsing via Docling.
Do I need an API key to use flatmark?
An API key is optional for casual requests under the anonymous tier. Supplying a FLATMARK_API_KEY unlocks your account allowance, including 100 free monthly credits.
