OpenDocKit — Claude Code MCP server: install and read files
OpenDocKit is an MCP server for Claude Code that reads local PDF, Office, EPUB, and email files as Markdown. It runs offline.
MIT ★ 42 updated 2026-11-16
claude mcp add --env OPENDOCKIT_MCP_ROOTS=<OPENDOCKIT_MCP_ROOTS> --transport stdio opendockit-mcp -- uvx opendockit-mcpWhat OpenDocKit does
OpenDocKit turns local PDF, Word, PowerPoint, Excel, CSV, HWP/HWPX, OpenDocument, RTF, EPUB, HTML, and email files into Markdown. Tables retain their row and column layout. document_outline shows a file's structure, while convert_document can return selected pages, slides, or sheets.
The server is read-only and sends nothing elsewhere. Access can be limited to folders with --root or OPENDOCKIT_MCP_ROOTS; without that setting, it can read files available to the user. Each response is capped by max_chars.
uvx is required to start it. Legacy .doc and .ppt files require LibreOffice. On Windows, HTML, email, and EPUB files cannot be read, and conversion has no time or memory limits.
What it helps with
- read a local PDF as Markdown
- extract a spreadsheet table without uploading the file
- load selected pages from a long document
- inspect a file outline before reading its text
Example prompts for the agent
- Read
report.pdfand return pages2-5as Markdown. - Show the structure of
budget.xlsx, then extract sheet3. - Convert
contract.docxto Markdown and report the converter warnings.
How to install OpenDocKit
Platform CLI
claude mcp add --env OPENDOCKIT_MCP_ROOTS=<OPENDOCKIT_MCP_ROOTS> --transport stdio opendockit-mcp -- uvx opendockit-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from opendockit-mcp <command>
Platform CLI
codex mcp add opendockit-mcp --env OPENDOCKIT_MCP_ROOTS=<OPENDOCKIT_MCP_ROOTS> -- uvx opendockit-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from opendockit-mcp <command>
Config file
{
"mcpServers": {
"opendockit-mcp": {
"command": "uvx",
"args": [
"opendockit-mcp"
],
"env": {
"OPENDOCKIT_MCP_ROOTS": "<OPENDOCKIT_MCP_ROOTS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from opendockit-mcp <command>
Config file
{
"servers": {
"opendockit-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"opendockit-mcp"
],
"env": {
"OPENDOCKIT_MCP_ROOTS": "<OPENDOCKIT_MCP_ROOTS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from opendockit-mcp <command>
Platform CLI
gemini mcp add -e OPENDOCKIT_MCP_ROOTS=<OPENDOCKIT_MCP_ROOTS> opendockit-mcp uvx opendockit-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from opendockit-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenDocKit
How do I install OpenDocKit in Claude Code?
Run claude mcp add opendockit -- uvx opendockit-mcp. This registers the MCP server and starts it through uvx.
What does OpenDocKit do?
It reads local documents and returns their contents as Markdown. It can inspect a file outline and fetch chosen pages, slides, or sheets.
What does OpenDocKit require?
It requires uvx. LibreOffice is needed for legacy .doc and .ppt files, while no API key is required. Windows cannot read HTML, email, or EPUB files.