Markdown MCP Server

Search, navigate, and extract content from local markdown files. Full-text search, section extraction, heading navigation, code block discovery, and frontmatter parsing.

Local serverstdioMIT

What is the Markdown MCP Server?

Mcp Server Markdown is an MCP project maintained in the ofershap/mcp-server-markdown repository. The maintainer describes its purpose as “Search, navigate, and extract content from local markdown files. Full-text search, section extraction, heading navigation, code block discovery, and frontmatter parsing”. Read the project documentation for the complete scope.

Installation

The documented npm package is mcp-server-markdown. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_filesList all .md files in a directory recursively (sorted alphabetically)
search_docsFull-text search across all .md files (case-insensitive, up to 50 results)
get_sectionExtract a section by heading until the next heading of same/higher level
list_headingsList all headings as a table of contents
find_code_blocksFind fenced code blocks, optionally filter by language (e.g. typescript)
get_frontmatterParse YAML frontmatter metadata at the start of a file

How to install the Markdown MCP Server

{
  "mcpServers": {
    "markdown": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-markdown"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.