A side-by-side look at the Markdown Notes MCP and Mdmagic MCP Server MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Markdown Notes MCP for workplace & productivity work as a local process; choose Mdmagic MCP Server for workplace & productivity as a local process. You can also run both side by side in one mcpServers block.
convert_to_markdown, convert_folder_to_markdown, save_summary.MDMAGIC_API_KEY.convert_document, validate_markdown, estimate_conversion_cost.Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Workplace & Productivity | Workplace & Productivity |
| Quality signal | 59/100 · Good | 51/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | Not declared |
| Pricing | Not declared | Not declared |
| Required env vars | None listed | MDMAGIC_API_KEY |
| Verified owner | Community listing | Community listing |
| GitHub stars | 0 | 0 |
| Directory activity | 3 views 0 installs 0 upvotes | 3 views 0 installs 0 upvotes |
| Tools | 4 | 10 |
| Full listing | View Markdown Notes MCP | View Mdmagic MCP Server |
convert_to_markdownConvert a document on this machine to clean Markdown. Handles PDF, Word (.docx), Excel (.xlsx/.xls/.xlsm), PowerPoint (.pptx), OpenDocument text and spreadsheets (.odt/.ods), EPUB, CSV/TSV and plain text. Images are read with OCR, and audio is transcribed. Conversion happens locally and the file is not uploaded, except for the image and audio cases noted in ocr_mode. Prefer this over reading a binary file directly.
The Markdown is SAVED AUTOMATICALLY beside the original, keeping the full original filename plus .md — report.pdf becomes report.pdf.md — so it is always clear which file it came from. The user does not need to ask for this. Short documents are also returned in full; long ones come back as a preview plus the saved path, to avoid filling the conversation with tens of thousands of words. If you need more of a long document than the preview shows, call this again with return_content "full".convert_folder_to_markdownConvert several documents at once and return a summary of what succeeded. Use when the user points at a set of files rather than one.save_summarySave a summary you have written about a document, as a .md file beside it. Call this WITHOUT being asked whenever you summarise, outline or answer a broad question about a document you converted — the user wants the summary kept, not just shown once in the chat. Do not call it for narrow factual lookups, and never invent a summary in order to save one: pass the text you actually produced.list_supported_formatsList the file extensions this server can convert, and report which optional cloud features are configured. Call this if a conversion fails as unsupported.convert_documentConvert Markdown → DOCX / PDF / HTML / all three. Returns a secure expiring URL.validate_markdownPre-flight check before conversion. Catches malformed tables, unclosed code fences, and other syntax issues that would produce broken output.estimate_conversion_costPre-flight cost estimate based on word count, page count, format, and template type.check_credit_balanceCurrent credit balance (subscription + purchased pools), plan status.list_all_templatesFull template catalog: 15 built-in templates (grouped by category) + your custom uploads.list_builtin_templatesOnly the built-in templates: Business (5), Creative (6), Professional (2), Technical (2).list_custom_templatesOnly your custom uploaded templates.get_template_detailsShow available variants (page sizes × orientations) for a specific template.recommend_templateSuggest the best built-in template for a described purpose ("Q4 board pack" → Executive_Platinum).show_default_settingsYour default page size, orientation, and template preferences.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.
{
"mcpServers": {
"markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
]
}
}
}
{
"mcpServers": {
"mdmagic-mcp-server": {
"command": "npx",
"args": [
"-y",
"@mdmagic/mcp-server@latest"
],
"env": {
"MDMAGIC_API_KEY": "YOUR_MDMAGIC_API_KEY_HERE"
}
}
}
}