# all2md

> all2md is an open-source MCP server for files and documents. Read, convert, search, diff and edit PDF, Word, PowerPoint and 40+ formats as Markdown. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://all2md.readthedocs.io/en/latest/mcp.html
- **Repository:** https://github.com/thomas-villani/all2md
- **MCP Registry name:** io.github.thomas-villani/all2md
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

all2md is a document-conversion library and command-line tool whose MCP mode gives an assistant seven tools over a folder you allow. `read_document_as_markdown` handles PDF, DOCX, PPTX, HTML, EPUB, XLSX and more, and can pull out one section by heading name or index. `search_documents` runs grep and BM25 keyword search across a corpus and returns ranked snippets, `diff_documents` returns a unified or JSON diff, `get_document_outline` lists headings, and `list_workspace_files` shows what the server may read.

Two tools can change files, `save_document_from_markdown` and `edit_document`, and both are off by default. File access is limited by allowlists, with network controls and path validation. By default the server sees only the current directory, and `all2md-mcp --temp` creates an isolated temporary workspace. Images can be embedded in base64 so a vision-capable model can see them.

Install with `pip install 'all2md[mcp]'` or run through uvx, Docker or a one-click `.mcpb` Claude Desktop extension. The project is MIT licensed.

## Features

- **Many input formats:** Reads PDF, Word, PowerPoint, HTML, EPUB, spreadsheets and more as Markdown.
- **Corpus search:** Grep plus BM25 keyword search returning ranked snippets.
- **Document diff:** Compares two documents as a unified or JSON diff.
- **Outline and section reads:** Lists headings and extracts a section by name or index.
- **Opt-in writes:** Saving and in-place editing are disabled until enabled.
- **Access controls:** File allowlists, network controls and path validation limit the server.

## Good for

- Have an assistant read a contract PDF and extract one section
- Search a folder of reports for a phrase
- Compare two versions of a Word document
- Get a heading outline of a long handbook
- Convert Markdown back to DOCX or PDF after enabling writes

## Install

### Claude Code (Terminal)

```sh
claude mcp add all2md -- uvx all2md
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "all2md": {
      "command": "uvx",
      "args": [
        "all2md"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "all2md": {
      "command": "uvx",
      "args": [
        "all2md"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "all2md": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "all2md"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "all2md": {
      "command": "uvx",
      "args": [
        "all2md"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "all2md": {
      "command": "uvx",
      "args": [
        "all2md"
      ]
    }
  }
}
```

## Tools

- `read_document_as_markdown`: Read and convert documents to Markdown
- `save_document_from_markdown`: Save Markdown to other formats, disabled by default
- `edit_document`: Apply structural edits in place, disabled by default
- `search_documents`: Grep and BM25 search over a corpus
- `diff_documents`: Unified or JSON diff of two documents
- `get_document_outline`: List a document's headings
- `list_workspace_files`: List files the server may read

## FAQ

### Can it modify my files?

Only if you enable it. Saving and editing tools are disabled by default.

### What can it read?

Only the folders you allow; by default the current directory, or a temporary workspace with --temp.

### How do I install it?

`pip install 'all2md[mcp]'`, uvx, Docker or the Claude Desktop .mcpb extension.

### What is the licence?

MIT.

### Is all2md free?

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

### How do I add all2md to Claude Code?

Run this command in your terminal: claude mcp add all2md -- uvx all2md

### What are the best alternatives to all2md?

The closest alternatives to all2md 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/all2md
