Markdown Ai MCP
Python MCP server for formatting, linting, converting and building tables and TOCs
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 1.0.10
- Listing updated
- today
Similar MCP servers
About Markdown Ai MCP
Markdown Ai MCP is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
The README describes this server as a set of Markdown utilities covering formatting, linting, conversion to HTML and PDF, table generation and table-of-contents building. It is distributed as a Python package on PyPI and runs over stdio, so it plugs into MCP clients such as Claude Desktop with a short JSON configuration entry.
The README names three tools in its examples: convert_to_html, generate_toc and lint_markdown. Beyond those names and the broad capability list, the README gives little detail on parameters or output formats, so behaviour should be checked against the package itself.
The project is MIT licensed and can be self-hosted. The README also describes the vendor's wider MEOK governance and compliance offering, which is separate from this utility server and is not required to use it.
Install
Run in a terminal
claude mcp add markdown-ai-mcp -- uvx markdown-ai-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"markdown-ai-mcp": {
"command": "uvx",
"args": [
"markdown-ai-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"markdown-ai-mcp": {
"command": "uvx",
"args": [
"markdown-ai-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"markdown-ai-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"markdown-ai-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"markdown-ai-mcp": {
"command": "uvx",
"args": [
"markdown-ai-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"markdown-ai-mcp": {
"command": "uvx",
"args": [
"markdown-ai-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- convert_to_html
- Converts Markdown to HTML (named in the README examples).
- generate_toc
- Generates a table of contents (named in the README examples).
- lint_markdown
- Lints Markdown content (named in the README examples).
What it does
- Markdown formatting
- Reformats Markdown documents through the server's formatting tool.
- Markdown linting
- Checks Markdown text for issues using the lint_markdown tool.
- HTML and PDF conversion
- Converts Markdown into HTML, with PDF output listed among the conversion options.
- Table generation
- Builds Markdown tables as part of the utility set.
- Table of contents builder
- Generates a table of contents from document headings via generate_toc.
- Stdio transport install
- Installs from PyPI or runs through uvx and works with any stdio-capable MCP client.
Good for
- Linting Markdown documentation from an AI assistant before publishing
- Converting Markdown notes or reports to HTML or PDF inside an MCP workflow
- Generating a table of contents for long Markdown files
- Creating formatted Markdown tables from data within a chat session
Pricing
Open source
Free and MIT licensed to self-host; vendor services are charged per job
Markdown Ai MCP FAQ
How do I install it?
The README gives pip install markdown_ai_mcp, a Smithery install command, and a uvx configuration for Claude Desktop.
What license does it use?
The README states the repository is MIT licensed and free to self-host.
Does it need an API key or environment variables?
The registry entry lists no environment variables for the package.
Is there a paid plan for this server?
The README says MEOK has no subscriptions or tiers and charges per job for services, with no public price list, but the server source itself is free to self-host.
Is Markdown Ai MCP free?
Yes. Markdown Ai MCP is open source, so you can use and self-host it for free.
How do I add Markdown Ai MCP to Claude Code?
Run this command in your terminal: claude mcp add markdown-ai-mcp -- uvx markdown-ai-mcp
What are the best alternatives to Markdown Ai MCP?
The closest alternatives to Markdown Ai MCP are Pdf Tools Ai MCP, Pdf Document MCP, Markdown to HTML Got Simplified, Pdf Merge Ai MCP and LoveMarkdown.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.