# Lakeboard Converter

> Lakeboard Converter is an open-source MCP server for files and documents. Read mind maps in nine formats as Markdown or JSON and build XMind files from Markdown. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web
- **Website:** https://convert.ledring.dev
- **Repository:** https://github.com/felixfangx/lakeboard-converter
- **MCP Registry name:** io.github.FelixFangX/lakeboard-converter
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

Mind maps tend to get stuck in whichever app made them, and this server lets an agent get the content out. It reads OPML (including MindNode exports), FreeMind and Freeplane, Lakeboard, XMind Zen and XMind 8, MindManager, iThoughts, SimpleMind, CSV outlines and Markdown outlines, and returns Markdown, JSON or a plain outline. Only Markdown and Lakeboard input can be written back out, as XMind files.

The README is open about what gets lost. Relationships, summary topics, encrypted topic bodies, non-http links and notes without plain text are reported in a losses field and on a note line, while styles, layout and icons are dropped without a warning. Zip inputs are refused above 32 MiB compressed, 32 MiB inflated or 1024 members, and the default node cap is 2000.

The same program also works as a command line tool and, through a separate site, as an in-browser converter where the file stays on your machine. It needs Node.js 20.12 or newer and is MIT licensed.

## Features

- **Nine input formats:** OPML, FreeMind, XMind, MindManager, iThoughts, SimpleMind, Lakeboard, CSV and Markdown outlines.
- **Markdown, JSON or outline:** read prints any of the three; JSON for multi-sheet files groups sheets with index and title.
- **Build XMind files:** from_markdown writes a .xmind at a path you give, or returns it as base64 with no path.
- **Loss reporting:** Dropped relationships, summaries and notes are listed rather than silently skipped.
- **Batch conversion:** convert_many takes 1 to 50 files at once.
- **Safety limits:** Zip size and member caps, a 2 MB Markdown input cap and a no-overwrite default.

## Good for

- Pull a colleague's XMind map into Markdown notes
- Feed a mind map to an assistant as structured JSON
- Convert a folder of OPML outlines in one call
- Generate an XMind file from a Markdown plan
- Inspect which format and sheets a map file contains

## Install

### Claude Code (Terminal)

```sh
claude mcp add lakeboard-converter -- npx -y lakeboard-converter
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lakeboard-converter": {
      "command": "npx",
      "args": [
        "-y",
        "lakeboard-converter"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lakeboard-converter": {
      "command": "npx",
      "args": [
        "-y",
        "lakeboard-converter"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "lakeboard-converter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lakeboard-converter"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lakeboard-converter": {
      "command": "npx",
      "args": [
        "-y",
        "lakeboard-converter"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lakeboard-converter": {
      "command": "npx",
      "args": [
        "-y",
        "lakeboard-converter"
      ]
    }
  }
}
```

## Tools

- `convert`: Converts a mind map file to Markdown or XMind (read-only).
- `convert_many`: Converts 1 to 50 files in one call.
- `inspect`: Reports a file's format and structure counts.
- `from_markdown`: Builds an XMind file from Markdown.

## FAQ

### Which formats can it write?

Only XMind, from Markdown or Lakeboard input.

### Will conversion lose information?

Some. Relationships, summaries, encrypted bodies and some links are reported as losses, and styles, layout and icons are omitted.

### Does it overwrite files?

Not unless the overwrite option is set.

### What are the tool names?

convert, convert_many, inspect and from_markdown.

### What are the requirements?

Node.js 20.12 or newer; install with npm install -g lakeboard-converter.

### Is Lakeboard Converter free?

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

### How do I add Lakeboard Converter to Claude Code?

Run this command in your terminal: claude mcp add lakeboard-converter -- npx -y lakeboard-converter

### What are the best alternatives to Lakeboard Converter?

The closest alternatives to Lakeboard Converter 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/lakeboard-converter
