Markdown MCP Server - install, status & alternatives [2026]

01 · Install Markdown

Claude Code

claude mcp add ofershap-mcp-server-markdown -- npx -y mcp-server-markdown

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mcp-server-markdown - unscoped; check the name against the project README before installing

registry namespace io.github.ofershap is GitHub-verified and matches the repo owner

03 · What Markdown can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all .md files in a directory recursively (sorted alphabetically), extract a section by heading until the next heading of same/higher level, list all headings as a table of contents, and find fenced code blocks, optionally filter by language (e.g. typescript).

The 6 tools it gives your agent

Extracted from the project's README - what markdown lets an agent do.

list_files: - List all .md files in a directory recursively (sorted alphabetically)
search_docs: - Full-text search across all .md files (case-insensitive, up to 50 results)
get_section: - Extract a section by heading until the next heading of same/higher level
list_headings: - List all headings as a table of contents
find_code_blocks: - Find fenced code blocks, optionally filter by language (e.g. typescript)
get_frontmatter: - Parse YAML frontmatter metadata at the start of a file

04 · Who maintains Markdown

markdown is maintained by ofershap. We track 15 MCP servers from ofershap - 15 actively maintained, 92 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from ofershap.

05 · Facts

repository: github.com/ofershap/mcp-server-markdown
category: documentation - ranked #80 of 183 actively-maintained documentation servers as of 2026-08-25.
registry: io.github.ofershap/markdown (active, first published 2026-03-10)
packages: npm:mcp-server-markdown

06 · Markdown FAQ

Is Markdown still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-10. We re-verify nightly.

What can Markdown do?

With this server connected, an agent can list all .md files in a directory recursively (sorted alphabetically), extract a section by heading until the next heading of same/higher level, list all headings as a table of contents, and find fenced code blocks, optionally filter by language (e.g. typescript).

How do I install Markdown?

Run `npx -y mcp-server-markdown`. You can also paste the ready-made client config above.

Does Markdown run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Markdown

Alternatives to Markdown

Maintained documentation servers if Markdown isn't the fit.

Pairs well with

Servers that cover what Markdown doesn't - only shown when the pairing reason fits the companion.

More documentation MCP servers · Open & Async · MinerU Open MCP · Orderly MCP · Compliance Trestle MCP · TriliumNext (trilium-MCP)

More TypeScript MCP servers · S3 (ofershap) · Scraper · SQLite · Microsoft 365 Admin · Clio MCP · see all