Skip to content

hyeonsang010716/opendockit

v0.3.13MIT

Read local documents as Markdown: PDF, Word, PowerPoint, Excel, HWP/HWPX, OpenDocument, RTF, EPUB, HTML and email, whole or by page, slide or sheet. Offline, through the OpenDocKit MCP server, with a skill for reading long documents in parts.

OpenDocKit for Hermes Agent

Lets Hermes Agent read the documents on your machine as Markdown: PDF, Word, PowerPoint, Excel, CSV, HWP / HWPX, OpenDocument, RTF, EPUB, HTML and email. Tables keep their rows and columns, merged cells are repeated in every row they cover, and a long document can be read one page, slide or sheet at a time, so it does not fill the context.

Hermes reads a Korean HWPX notice through the plugin and adds up the 2026 budget of the youth programs, keeping each row of a merged cell under its own field

Hermes with Claude Sonnet 5.5, recorded unedited. The notice is fictional; the label of the merged "field" cell is repeated in every row, so the three lines named 구직 활동 수당 (job-seeking allowance) stay apart.

It is a portable Agent Plugins v1 package around the MCP server of OpenDocKit (MIT). One install ships:

  • mcp.json — the opendockit MCP server, started for every new session while the plugin is enabled. No mcp_servers edits in config.yaml.
  • skills/opendockit/ — when to use which tool, how to read a long document in parts, and what a scanned page or a warning means.

This is an independent community plugin, listed in the Hermes plugin catalog (entry). It is not affiliated with Nous Research.

Install

hermes plugins install opendockit      # from the Hermes plugin catalog
hermes plugins enable opendockit

The catalog installs the commit its entry pins (see Version pinning). To try a newer commit, install from this repository:

hermes plugins install hyeonsang010716/OpenDocKit#hermes-plugin

Then start a new Hermes session and ask it to read a file:

Summarise ~/Documents/quarterly-report.hwp and list the figures in its tables.

No account and no API key.

What you get

ToolWhat it returns
document_outline(path)Format, title, size, and the numbered pages / slides / sheets with their titles and lengths — no text
convert_document(path, sections=None, max_chars=100000)The Markdown of the file, or of the pages / slides / sheets asked for ("3" or "2-5"), followed by the converter's warnings

Hermes exposes them as mcp__opendockit__document_outline and mcp__opendockit__convert_document. Both are marked read-only.

One call returns at most max_chars characters of the document. A longer one is cut with a note that tells the agent to read the outline and ask for sections, which is what the bundled skill teaches it to do first; a document without pages, slides or sheets has nothing to ask for, and its note says to raise max_chars instead.

What it does on your machine

  • Runs a local process. uvx --python ">=3.12" --exclude-newer 2026-11-17T07:03:00Z --from "opendockit[mcp]==0.3.13" opendockit-mcp, over stdio, for as long as the session lives. uvx is the one Hermes manages.
  • Downloads once. The first start fetches opendockit 0.3.13 and its dependencies from PyPI into uv's cache, and a Python 3.12 or newer if the machine has none. The opendockit version is pinned, and --exclude-newer keeps its dependencies at the releases that existed on that date, so every install resolves the same set.
  • Reads files, writes none. By default the server can read any file your user can read, like the agent's own file tools. To restrict it, set OPENDOCKIT_MCP_ROOTS in your shell or in the profile's .env to the folders it may read (separated like PATH); files outside them, also through symbolic links, are refused.
  • No network when converting. No telemetry, no vision model, nothing uploaded. Legacy .doc / .ppt start a local LibreOffice if one is installed and are refused if not.
  • One file cannot take the session down. On Linux and macOS every conversion runs in a disposable worker process that is ended after 2 minutes, and on Linux also when it passes 2 GB of memory. On Windows it runs inside the server, without those limits.
  • The text of a document is data. A document can contain sentences addressed to the agent. The server returns what the file says, and the skill tells the agent to quote such text, not to follow it.
  • No credentials are read or stored.

Limits

  • No OCR. A scanned PDF or a photo comes back as a placeholder with a warning; the skill tells the agent to say so.
  • Pictures are [Image] placeholders. Charts built from data in an Office file come back as data tables.
  • On Windows, HTML, email and EPUB are not supported.
  • The full list is in docs/limitations.md.

Health check without Hermes

uvx --python ">=3.12" --exclude-newer 2026-11-17T07:03:00Z --from "opendockit[mcp]==0.3.13" opendockit-mcp <<'EOF'
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}
EOF

A line of JSON naming the server opendockit means it starts.

Version pinning

mcp.json pins opendockit[mcp]==0.3.13 and resolves its dependencies as of 2026-11-17. A newer OpenDocKit, or a newer release of a dependency, reaches catalog installs only through a commit here that moves the pin, followed by a reviewed SHA bump in the Hermes plugin catalog. The package never updates itself.

License

MIT, like OpenDocKit.