PDFStruct v0.2.1

PDFStruct converts documents on your own computer. 0.2.1 changes how it is installed on Windows and how it connects to Claude. Conversion, the command line, the desktop window and the MCP tools are unchanged. Free and open source (MIT): no account, no telemetry, no usage limits.

Two ways to get it on Windows

Recommended Windows Setup

PDFStruct-Windows-Setup-0.2.1.zip

For:

• normal installation (needs Python 3.10 to 3.13)
• updater and rollback
• Claude Desktop
• Claude Code
• Cowork
• MCP and skill/plugin integration

Unpack it and run install-windows.cmd.

No-Python Portable

PDFStruct-Portable-0.2.1-win64.zip

For:

• the desktop window without installing Python (PDFStruct.exe)
• the command line without installing Python (pdfstruct-cli.exe)
• document conversion on your computer

Please note:

• Extract the ZIP before running; do not start the programs from inside the ZIP.
• It is large (about 325 MB, about 800 MB unpacked) because Qt and the OCR runtime are included.
• OCR models are not included and may download on first OCR use.
• The build is unsigned, so Windows SmartScreen may warn.
• Portable has no updater.
• Portable has no MCP, Claude plugin or skill integration. Claude users should use Windows Setup.

Setup and Portable are alternatives for ordinary conversion; you need only one.

New in 0.2.1

• Windows install outside any source folder. install-windows.cmd installs the release wheel into its own folder per version, %USERPROFILE%\.local\pdfstruct\v<version>, checks it (import, command line, MCP server) and only then points the stable link %USERPROFILE%\.local\pdfstruct\current at it.
• Updates you confirm. update-windows.cmd shows the active and the latest stable version and asks before it downloads. The download is verified against its SHA-256 checksum, installed next to the old version, checked, and only then made active. -Check only looks, -List shows installed versions, -Rollback goes back to the previous one, which is always kept. Nothing runs in the background.
• Claude Code / Cowork plugin (pdfstruct-plugin.zip): the skill plus the registration of the PDFStruct MCP server.
• Claude Desktop extension (pdfstruct-0.2.1.mcpb): a plain launcher, no Node layer, nothing to configure.
• One skill source. The plugin and pdfstruct-skill.zip are built from the same file. The skill is shorter and uses the MCP tools only in Claude Desktop chat.

Claude: install order

1. Install with PDFStruct-Windows-Setup-0.2.1.zip (install-windows.cmd).
2. Claude Desktop chat: install pdfstruct-0.2.1.mcpb (Settings, Extensions, Advanced settings, Install Extension).
3. Claude Code / Cowork: install pdfstruct-plugin.zip.

• The .mcpb and the plugin contain no runtime. They start current\Scripts\pdfstruct-mcp.exe, so step 1 must be done first. After a later update they need no reinstall.
• If you use the plugin, do not also upload pdfstruct-skill.zip: the plugin already contains the same skill. The skill ZIP is only for people who do not use the plugin.

Files

File	Use
PDFStruct-Windows-Setup-0.2.1.zip	Recommended: install and update scripts plus the wheel
PDFStruct-Portable-0.2.1-win64.zip	Desktop window and command line, no Python needed
pdfstruct-0.2.1.mcpb	Claude Desktop extension
pdfstruct-plugin.zip	Claude Code / Cowork plugin
pdfstruct-skill.zip	The skill alone (alternative to the plugin)
pdfstruct-0.2.1-py3-none-any.whl, pdfstruct-0.2.1.tar.gz	Python package
SHA256SUMS.txt	SHA-256 checksums of the seven files above

The portable package was added to this release after the first publication; SHA256SUMS.txt was extended by its line, and the other files are unchanged.

See the README for the quick starts.