Prepare the server locally
Run this once before adding it to Claude Code.
npm install
npm run buildRegister it in Claude Code
claude mcp add markdown-tools -- node /path/to/dist/index.jsReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
markdown-tools's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Automatic table of contents generation
- Comprehensive markdown linting for syntax and style issues
- Markdown formatting and prettification
- Detailed content statistics including reading time and block distribution
- JSON to Markdown table conversion
Tools 5
generate_tocGenerate a table of contents from markdown headings.lint_markdownCheck markdown for common issues like broken links, heading hierarchy, and whitespace.format_markdownFormat and prettify markdown content, normalizing styles and aligning tables.markdown_statsCompute detailed statistics from markdown content including word count and reading time.generate_tableGenerate formatted markdown tables from JSON data.Try it
Original README from rog0x/mcp-markdown-tools
mcp-markdown-tools
An MCP (Model Context Protocol) server that provides tools for working with Markdown content. Analyze, lint, format, and generate Markdown programmatically through any MCP-compatible client.
Tools
generate_toc
Generate a table of contents from markdown headings. Configure minimum/maximum heading depth and choose between ordered or unordered list output.
lint_markdown
Check markdown for common issues including broken link syntax, heading hierarchy violations, trailing whitespace, missing image alt text, inconsistent list markers, and excessive blank lines.
format_markdown
Format and prettify markdown content. Normalizes heading styles (converts setext to ATX), fixes spacing around headings and blocks, aligns table columns, and wraps long lines at configurable width.
markdown_stats
Compute detailed statistics from markdown content: word count, character count, estimated reading time, headings by level, link count, image count, code block count with language distribution, list items, blockquotes, and paragraph count.
generate_table
Generate formatted markdown tables from JSON data. Supports column selection, custom header labels, and per-column alignment (left, center, right).
Installation
npm install
npm run build
Usage with Claude Desktop
Add the following to your Claude Desktop configuration file:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"markdown-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
}
}
}
Usage with Claude Code
Add the server using the Claude Code CLI:
claude mcp add markdown-tools node D:/products/mcp-servers/mcp-markdown-tools/dist/index.js
Or add it to your .mcp.json configuration:
{
"mcpServers": {
"markdown-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-markdown-tools/dist/index.js"]
}
}
}
Development
npm install
npm run build
npm start
License
MIT