Balmas MCP vs Markitdown
A side-by-side look at the Balmas MCP and Markitdown MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
MarkitdownFile Systems · Local subprocess (stdio)MCP tool access to MarkItDown -- a library that converts many file formats (local or remote) to Markdown for LLM consumption.67GreatAuth: no auth requiredVerdict: choose Balmas MCP for file systems work as a local process; choose Markitdown for file systems as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Balmas MCP when
- You need dedicated capabilities in the File Systems domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
BALMAS_API_KEY. - You want tools like
list_files, read_clean_file, restore_text.
Choose Markitdown when
- You need dedicated capabilities in the File Systems domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: No auth required.
- You want tools like
convert_to_markdown.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | Markitdown | |
|---|---|---|
| Category | File Systems | File Systems |
| Quality signal | 52/100 · Good | 67/100 · Great |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | No auth required |
| Pricing | Not declared | Free |
| Required env vars | BALMAS_API_KEY | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 0 | 191,245 |
| Directory activity | 1 views 0 installs 0 upvotes | 6 views 0 installs 0 upvotes |
| Tools | 3 | 1 |
| Full listing | View Balmas MCP | View Markitdown |
Tools & capabilities
Balmas MCP tools 3
list_filesNames, sizes, types inside allowed folders — never contentsread_clean_fileThe file's text after local anonymizationrestore_textReal values back into its output (session tokens only)
Markitdown tools 1
convert_to_markdownConvert a resource described by an http:, https:, file: or data: URI to markdown
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Balmas MCP
{
"mcpServers": {
"balmas-mcp": {
"command": "npx",
"args": [
"-y",
"balmas-mcp"
],
"env": {
"BALMAS_API_KEY": "YOUR_BALMAS_API_KEY_HERE"
}
}
}
}
Markitdown
{
"mcpServers": {
"microsoft-markitdown": {
"command": "uvx",
"args": [
"markitdown-ocr"
]
}
}
}
Frequently asked questions
Balmas MCP is categorized under File Systems and uses a local stdio subprocess. Markitdown belongs to File Systems and uses a local stdio subprocess. Pick Balmas MCP for file systems work and Markitdown for file systems.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Balmas MCP has no declared pricing — check the project's own site. Markitdown is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add balmas-mcp and microsoft-markitdown as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Balmas MCP has a quality signal of 52/100 (Good) with 1 views, 0 installs and 0 GitHub stars. Markitdown has 67/100 (Great) with 6 views, 0 installs and 191,245 GitHub stars.