# go-docs-mcp

> go-docs-mcp is an open-source MCP server for files and documents. Single-binary server that reads PDFs, Office files, EPUB and images with OCR and search. It runs locally on your machine and is started by your AI client.

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

## About

One compiled Go binary exposes 13 tools over stdio, with no Node.js or Python runtime. It reads PDF, text, Markdown, CSV, DOCX, XLSX, PPTX, ODT, EPUB, HTML, RTF, Jupyter notebooks and images (PNG, JPG, WebP, TIFF, BMP). PDF support uses poppler, Office and similar formats use pandoc, and OCR uses tesseract; the format list tool shows which are installed.

Long documents arrive in pieces through offset and max_chars (50,000 characters by default). Text is cached in memory by modification time, and every document is also a docs:// resource that Claude Code can @-mention. Pulled-out PDF images come back as PNG, scaled to 1600 px, up to 10 per call.

The README says everything runs on your machine and no document goes to a cloud API. Access is read-only and confined to one folder, symlinks pointing out of it are refused, and URL downloads (50 MB maximum) refuse private and loopback hosts. It installs with Homebrew, go install or a release binary on macOS, Linux and Windows.

## Features

- **Many formats:** PDF, Office files, EPUB, HTML, RTF, notebooks and images from one server.
- **OCR:** Reads scanned PDFs and images with tesseract.
- **Paged output:** offset and max_chars keep long documents from flooding context.
- **Tables and images:** Extract tables as structured data and PDF images as PNG.
- **Folder-locked and read-only:** Documents are confined to one directory.
- **Resource support:** Documents appear as docs:// resources.

## Good for

- Summarise a scanned contract with OCR
- Search for a term inside a 300-page PDF
- Pull tables out of a spreadsheet or report
- Convert a document to Markdown
- Read a document from a URL

## Install

### Claude Code (Terminal)

```sh
claude mcp add go-docs-mcp -- docker run -i --rm ghcr.io/drolosoft/go-docs-mcp:1.5.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "go-docs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "go-docs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "go-docs-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "go-docs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "go-docs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/drolosoft/go-docs-mcp:1.5.0"
      ]
    }
  }
}
```

## Tools

- `list_documents`: Lists documents in the configured folder with format, pages and size.
- `list_formats`: Lists supported formats and which external tools are installed.
- `read_document`: Reads full text, one page or a page range.
- `read_url`: Downloads a document from a URL and reads its text.
- `convert_to_markdown`: Converts a document to Markdown.
- `search_document`: Searches within a document with context.
- `get_document_summary`: Gives an overview from the first 3 pages.
- `get_document_metadata`: Extracts title, author, dates and page count.
- `get_document_outline`: Returns the heading structure.
- `extract_tables`: Extracts tables as structured data.
- `extract_images`: Extracts PDF images as PNG.
- `ocr_document`: Forces OCR on scanned or image-based PDFs.
- `read_image`: Extracts text from images with OCR.

## FAQ

### Does it need Node.js or Python?

No. It is a single Go binary, though PDF, Office and OCR support use poppler, pandoc and tesseract.

### Does it send documents to the cloud?

The README says no; everything runs locally.

### Can it read a URL?

Yes, with read_url, up to 50 MB; private and loopback hosts are refused.

### How is access limited?

It is read-only and locked to one folder.

### How do I install it?

With brew, go install, or a release download; the registry lists a release binary.

### Is go-docs-mcp free?

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

### How do I add go-docs-mcp to Claude Code?

Run this command in your terminal: claude mcp add go-docs-mcp -- docker run -i --rm ghcr.io/drolosoft/go-docs-mcp:1.5.0

### What are the best alternatives to go-docs-mcp?

The closest alternatives to go-docs-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/go-docs-mcp
