The typical arrival at this page: someone has switched to a Mac, or inherited a hard drive, and has a folder of .one files from an old Windows PC. OneNote is installed. Nothing opens. The obvious conclusion — that the file must be broken — is usually wrong.

Why the Mac app behaves this way

OneNote comes in several forms, and they differ in one respect that decides everything here: whether they can work with a notebook stored on a local drive.

  • OneNote for Windows (desktop) — can work with local notebooks as well as cloud ones. It is the only version that can.
  • OneNote for Mac — documented as working with notebooks hosted on OneDrive, OneDrive for Business or a SharePoint library.
  • OneNote on the web — cloud notebooks only.

So a loose .one on a Mac is not a notebook as far as the app is concerned. It is a section file with no notebook around it. There is nothing wrong with the file; it is simply in the wrong shape for the app you are pointing at it.

Remember too what a notebook actually is on disk: a folder containing one .one per section plus a .onetoc2 index. Our guide to the OneNote file formats unpacks that if you want the detail.

Copy first. Duplicate every .one file into a working folder and leave the originals alone. Several routes below involve conversion or upload, and conversions are one-way. Two minutes of copying removes all of that risk.

Route 1 — try the app's own Open Section item (free, 30 seconds)

Some builds of OneNote for Mac expose a menu item for opening a section file directly — reported by third-party OneNote add-in developers, and worth checking in your own copy under the File menu. It costs nothing and takes half a minute.

Be prepared for it not to be there, or for it to decline a very old file. Microsoft's documented position remains that the Mac app is built around cloud notebooks, so treat this as a lucky shortcut rather than the plan.

Route 2 — go through Windows once (free, most complete result)

This is the route that recovers the most, because it uses the one OneNote that fully understands local section files. You need Windows access once — a real PC, a borrowed machine, a work laptop, or a virtual machine on your Mac.

  1. Install the OneNote desktop app for Windows. It is available as a free standalone download and does not need an Office subscription.
  2. Right-click the .one file and choose Open with › OneNote. It appears under Opened Sections.
  3. Create a new notebook and save it to OneDrive, not to the local disk. This step is the whole point.
  4. Right-click the section tab, choose Move or Copy, pick the new cloud notebook and click Copy.
  5. Let it sync. On your Mac, open OneNote, sign in with the same account, and the notebook is there.

If Windows OneNote objects that the section came from an older version, that is a documented and fixable situation — see what the “older version of OneNote” message means.

The limit: it requires Windows, and OneNote 2003-format files remain out of reach even there.

Route 3 — uploading to OneDrive on its own (usually not enough)

The intuitive move is to drag the .one into OneDrive and hope OneNote picks it up. It generally does not, for the reason above: OneNote is looking for a notebook folder with a table of contents, and you have given it an orphaned section.

Uploading is still worth doing as a backup — an off-machine copy of an irreplaceable file is never wasted — just do not expect it to be the fix.

Route 4 — open-source parsers, from Terminal (free, technical)

Microsoft published the OneNote format specifications, and several open-source projects read .one files directly. They run perfectly well on macOS:

  • onenote2xml — Python modules that read .one sections and .onetoc2 notebooks and produce XML or JSON.
  • pyOneNote — a lightweight reader, originally written for security analysis, good at surfacing structure and embedded objects.
  • one-extract — a script for pulling files and metadata out of a .one.
  • Aspose.Note FOSS — an open-source library with a Python distribution that walks the document tree for text nodes.

Realistic expectations: you will install Python, read a README, and get structured output rather than a notebook. Coverage varies between projects and between file versions. For one file and an afternoon, genuinely good. For a folder of forty and a deadline, less so.

Route 5 — a local, read-only recovery tool (what we make)

If Windows is not available to you and what you actually need is the typed text back rather than a fully reconstructed notebook, that is the gap OneNote Rescue is built for. It is a small desktop app rather than a script — the difference from the projects above is that it gives you a readable notebook rather than raw XML to process yourself. It runs on your own Mac or PC, reads your own section file, and writes out page titles and note text as plain text, a readable per-page HTML notebook, and a JSON report of what it found.

Three things about how it behaves, because they are the reasons to trust it with an irreplaceable file:

  • Read-only, and checkable. Your source .one is copied to a temporary location and only the copy is read. Nothing is ever written next to your original, and its bytes and timestamp are unchanged.
  • Local, with nothing uploaded. The app’s only online action is checking your licence key with Lemon Squeezy; your .one file and everything recovered from it stay on your machine. There is no account and no hidden upload path.
  • Open outputs. Plain text, HTML and JSON. Nothing you get out needs our software, or anyone's, to read in ten years.

Honest scope, so you can decide before you spend anything. OneNote Rescue recovers page titles and note text. From a OneDrive-format section it also writes the embedded images out as real files next to the notebook — along with any other embedded file whose type it recognises by its file signature — each with its SHA-256 recorded in the report. From a classic desktop revision store, embedded files are noted in the report but not extracted in this pass. Ink and handwriting strokes are noted, not converted to text, and any object it cannot identify is listed as present and not extracted rather than guessed into a file. Rich formatting and the exact page hierarchy are simplified into readable text. Nothing is ever decrypted or bypassed: password-protection markers are flagged in the classic revision store, and are not detected in the OneDrive-format container in this pass.

Supported operating systems: Windows 10 and 11 (64-bit), and macOS 10.15 or later. One purchase covers both, so you can recover the files where they already are — no copying them to another machine first.

Which means: if your notes are mostly typed, this reads them back. If they are mostly sketches or scans, it recovers the text around them and tells you what it left behind. And if Route 2 is open to you, take Route 2 — Windows OneNote will give you a fuller result than we can.

The short version for Mac users

  1. Copy the files; work on copies.
  2. Check the File menu for an Open Section item — 30 seconds, free.
  3. Check whether a cloud copy already exists at onenote.com under the account that made the notes.
  4. If you can reach Windows once, do Route 2 — it recovers the most.
  5. If you cannot, use an open-source parser or a local recovery tool to get the text out.

Whichever route you take, keep the original files afterwards. They cost almost nothing to store, and a future tool may read more from them than today's can.