Markdown Notes MCP vs MCP Server
A side-by-side look at the Markdown Notes MCP and 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 MCP Server for workplace & productivity as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Markdown Notes MCP when
- You need dedicated capabilities in the Workplace & Productivity domain.
- You prefer a local stdio subprocess transport.
- You want tools like
convert_to_markdown, convert_folder_to_markdown, save_summary.
Choose MCP Server when
- You need dedicated capabilities in the Workplace & Productivity domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: API key required.
- You have the keys it needs:
UNMARKDOWN_API_KEY, UNMARKDOWN_API_URL. - You want tools like
convert_markdown, create_document, list_documents.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Workplace & Productivity | Workplace & Productivity |
| Quality signal | 59/100 · Good | 56/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | API key required |
| Pricing | Not declared | BYOK (pay the provider) |
| Required env vars | None listed | UNMARKDOWN_API_KEYUNMARKDOWN_API_URL |
| Verified owner | Community listing | Community listing |
| GitHub stars | 0 | 1 |
| Directory activity | 3 views 0 installs 0 upvotes | 4 views 0 installs 0 upvotes |
| Tools | 4 | 7 |
| Full listing | View Markdown Notes MCP | View MCP Server |
Tools & capabilities
Markdown Notes MCP tools 4
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.
MCP Server tools 7
convert_markdownConvert markdown to styled HTML for any of 8 destinationscreate_documentCreate a new document in your library (optionally in a folder)list_documentsList saved documents with pagination (optionally filter by folder)get_documentFetch a document by ID with full contentupdate_documentModify a document's title, content, template, metadata, or folderpublish_documentPublish a document to a shareable public URLget_usageCheck API quota for the current billing month
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.
Markdown Notes MCP
{
"mcpServers": {
"markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
]
}
}
}
MCP Server
{
"mcpServers": {
"unmarkdown-mcp-server": {
"command": "npx",
"args": [
"-y",
"@un-markdown/mcp-server"
],
"env": {
"UNMARKDOWN_API_KEY": "YOUR_UNMARKDOWN_API_KEY_HERE",
"UNMARKDOWN_API_URL": "YOUR_UNMARKDOWN_API_URL_HERE"
}
}
}
}
Frequently asked questions
Markdown Notes MCP is categorized under Workplace & Productivity and uses a local stdio subprocess. MCP Server belongs to Workplace & Productivity and uses a local stdio subprocess. Pick Markdown Notes MCP for workplace & productivity work and MCP Server for workplace & productivity.
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.
Markdown Notes MCP has no declared pricing — check the project's own site. MCP Server is bring-your-own-key: usage is billed by the API provider you supply a key for. Auth: api key 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 markdown-notes-mcp and unmarkdown-mcp-server as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Markdown Notes MCP has a quality signal of 59/100 (Good) with 3 views, 0 installs and 0 GitHub stars. MCP Server has 56/100 (Good) with 4 views, 0 installs and 1 GitHub stars.