# Markdown MCP

> Markdown MCP is an open-source MCP server for files and documents. Convert markdown to HTML and extract headings locally. No network and no key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/mrfentmen/awesome-servers
- **MCP Registry name:** io.github.mrfentmen/markdown-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-13

## About

Convert markdown to HTML and extract headings locally. No network and no key.

## Install

### Claude Code (Terminal)

```sh
claude mcp add markdown-mcp -- npx -y @mrfentmen/markdown-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "markdown-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/markdown-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "markdown-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/markdown-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "markdown-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/markdown-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "markdown-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/markdown-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "markdown-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/markdown-mcp"
      ]
    }
  }
}
```

## FAQ

### Is Markdown MCP free?

Yes. Markdown MCP is open source, so you can use and self-host it for free.

### How do I add Markdown MCP to Claude Code?

Run this command in your terminal: claude mcp add markdown-mcp -- npx -y @mrfentmen/markdown-mcp

### What are the best alternatives to Markdown MCP?

The closest alternatives to Markdown MCP are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

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