Summary
This server gives Claude five tools for working with Markdown files programmatically. You can generate tables of contents with configurable depth, lint documents for broken links and heading hierarchy issues, format content by normalizing heading styles and wrapping lines, pull statistics like word count and reading time, and create aligned tables from JSON data. It's built for workflows where you need structured Markdown operations beyond simple text editing, like maintaining documentation, analyzing content structure, or generating formatted output from data. Runs via Node.js and connects through stdio transport.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
1 tools
to-markdownGenerate markdown description for files including PDF (.pdf), Images (.jpeg, .jpg, .png, .webp, .svg), HTML (.html), XML (.xml), Microsoft Office (.xlsx, .xlsm, .xlsb, .xls, .et), Open Document Format (.ods), CSV (.csv), and Apple Documents (.numbers)1 params
Generate markdown description for files including PDF (.pdf), Images (.jpeg, .jpg, .png, .webp, .svg), HTML (.html), XML (.xml), Microsoft Office (.xlsx, .xlsm, .xlsb, .xls, .et), Open Document Format (.ods), CSV (.csv), and Apple Documents (.numbers)
Parameters* required
filePathsarrayArray of absolute file paths to generate descriptions for
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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
Package@rog0x/mcp-markdown-tools
TransportSTDIO
UpdatedMar 22, 2026
