Markdown MCP server
Markdown MCP — search, extract sections, list headings, find code blocks.
7 stars
Reviews
Write oneNobody has reviewed Markdown yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Markdown tools (6)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
find_code_blocksFind all fenced code blocks in a markdown file. Optionally filter by language (e.g. typescript, python).
get_frontmatterParse YAML frontmatter (between --- delimiters) at the start of a markdown file. Returns key-value metadata.
get_sectionExtract a section by heading from a markdown file. Returns content from that heading until the next heading of same or higher level.
list_filesList all .md files in a directory recursively. Returns relative paths sorted alphabetically.
list_headingsList all headings (# through ######) in a markdown file as a table of contents.
search_docsFull-text search across all .md files in a directory. Returns file, line number, and matching line. Limited to 50 results.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 49 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install Markdown in Claude Code, Cursor or VS Code
Runs npx -y mcp-server-markdown on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add markdown -- npx -y mcp-server-markdown
What the publisher says
From the Markdown repository's README, as published. We do not edit it. Read it on GitHub
mcp-server-markdown
Search, navigate, and extract content from local markdown files. Full-text search, section extraction, heading navigation, code block discovery, and frontmatter parsing.
npx mcp-server-markdownWorks with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Reads local .md files, no auth needed.
Demo built with remotion-readme-kit
Why
Tools like Context7 are great for looking up library docs from npm, but they don't help with your own documentation. Project wikis, internal knowledge bases, architecture decision records, onboarding guides: they all live as markdown files in your repo or on disk. The filesystem MCP server can read those files, but it treats them as raw text. It doesn't understand headings, sections, or code blocks. This server does. Point it at a directory and your assistant can search across all your docs, pull out a specific section by heading, list the table of contents, or find every TypeScript code example in your knowledge base.
Tools
Quick Start
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"markdown": {
"command": "npx",
"args": ["-y", "mcp-server-markdown"]
}
}
}Claude Desktop
Add to claudedesktopconfig.json:
{
"mcpServers": {
"markdown": {
"command": "npx",
"args": ["-y", "mcp-server-markdown"]
}
}
}VS Code
Add to user settings or .vscode/mcp.json:
{
"mcp": {
"servers": {
"markdown": {
"command": "npx",
"args": ["-y", "mcp-server-markdown"]
}
}
}
}Examples
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Markdown: common questions
- Is Markdown MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Markdown safety report
- How do I install Markdown?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Markdown need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Markdown maintained?
- The last commit was 64 days ago (2026-08-10). The latest release is v1.0.1.
- What can I use instead of Markdown?
- Servers from other publishers that do the same job: Mistral MCP server, Rendex: Rendering API for Images, PDFs & Content Extraction MCP server and Brightdata MCP server. Compare all Markdown alternatives.
Alternatives to Markdown
Same job from other publishers: the closest match first, then the best rated.
- MistralMistral MCP server: extract invoices and documents from text, Markdown or OCR into typed JSON.not reviewedGrowingB
- Rendex: Rendering API for Images, PDFs & Content ExtractionRender HTML, Markdown, or URLs to images, PDF, or branded artifacts; extract and watch pages.not reviewedGrowingA
- BrightdataBright Data's Web MCP server enabling AI agents to search, extract & navigate the webnot reviewedEstablishedB
- Browser UseControl a real Chrome browser to complete any task: fill forms, extract data, book flights.not reviewedEstablishedA
- SkyvernAI-powered browser automation — navigate, click, fill forms, and extract data from any website.not reviewedEstablishedA