# Markdown Ai MCP

> Markdown Ai MCP is an open-source MCP server for files and documents. Python MCP server for formatting, linting, converting and building tables and TOCs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/csoai-org/markdown-ai-mcp
- **MCP Registry name:** io.github.CSOAI-ORG/markdown-ai-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [content publishing](https://ai-powered.com/categories/content-publishing)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add markdown-ai-mcp -- uvx markdown-ai-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "markdown-ai-mcp": {
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markdown-ai-mcp": {
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "markdown-ai-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "markdown-ai-mcp": {
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markdown-ai-mcp": {
      "command": "uvx",
      "args": [
        "markdown-ai-mcp"
      ]
    }
  }
}
```

## Tools

- `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).

## 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.

## Alternatives

- [Pdf Tools Ai MCP](https://ai-powered.com/mcp/pdf-tools-ai-mcp): Pdf Tools Ai MCP is an open-source MCP server for files and documents.
- [Pdf Document MCP](https://ai-powered.com/mcp/pdf-document-mcp): Pdf Document MCP is an open-source MCP server for files and documents.
- [Markdown to HTML Got Simplified](https://ai-powered.com/mcp/markdown-to-html-got-simplified): Markdown to HTML Got Simplified is a freemium MCP server for files and documents.
- [Pdf Merge Ai MCP](https://ai-powered.com/mcp/pdf-merge-ai-mcp): Pdf Merge Ai MCP is an open-source MCP server for files and documents.
- [LoveMarkdown](https://ai-powered.com/mcp/lovemarkdown): LoveMarkdown is an open-source MCP server for files and documents.
- [markitai](https://ai-powered.com/mcp/markitai): markitai is an open-source MCP server for files and documents.
- [Pdf MCP](https://ai-powered.com/mcp/pdf-mcp): Pdf MCP is an open-source MCP server for files and documents.
- [Markdown Logic Express](https://ai-powered.com/mcp/markdown-logic-express): Markdown Logic Express is a free MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/markdown-ai-mcp
