Skip to content
MCP server

Markdown Ai MCP

Python MCP server for formatting, linting, converting and building tables and TOCs

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "markdown-ai-mcp": {
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "markdown-ai-mcp": {
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers