notes2notion

⚠️ Unofficial API: This script was written using the unofficial Notion API. Now that the official API client has been released, this script may not work until I get the time to port to the official API. Unfortunately, the new API does not have all required features to import content from Notes. If anyone would like to contribute, feel free to submit a pull request or contact me directly.

This is a basic script that will import from Apple Notes directly into Notion.

When working with your data, always make a backup and/or perform testing in a safe area to ensure that your valuable data is protected!

Requirements

The script requires python3. The easiest way to install on macOS is using Homebrew:

brew install python3

Dependencies

You will also need to install the dependencies using pip:

python3 -m pip install -r requirements.txt

For advanced users, you may want to do this in a virtual environment to avoid conflicts with your system modules.

Usage

You will need to edit the default configuration file. Specifically, you need to set up an integration for your Notion workspace and set the auth_token property. In addtion, you will need to provide the ID or URL of the top-level archive page where notes will be imported. This page must be shared with your integration token.

For more information on setting up the workspace integration, visit the official Authorization Guide.

There are several other configuration options that control how the script handles note content. Check the configuration document in the script for more details.

Run the script, as shown:

python3 main.py --config notes2notion.yaml

You will see the script print the name of each note as it is processed.

Limitations

Apple Notes only exports a limited set of the formatting from the original note. Specifically, many colors, font sizes, font styles, etc are not preserved.

Underline is not preserved due to a limitation in Markdown.

Hyperlinks are not preserved, since they are not exported from Apple Notes.

Attachments (other than pictures) are not uploaded. We can provide some metadata for attachments to help track them down, but the note does not contain enough information to add them in the export.

Tables are converted to Notion databases, which may alter the appearance or structure for some types of tables.

Known Issues

Formatting (such as bold, color, etc) and tables are not fully supported.

Attachements (like pictures and scanned documents) are not currently supported. The official API does not have an "upload" method at this time.

The script is VERY slow. This is due to the way blocks are built using the notion-py client. Essentially, each "block" in the source note is reconstructed on the server one-by-one. I'm sure there are ways to improve this, I just haven't taken the time to do so.

Some characters in title blocks (especially quotes) or styling can cause odd behavior in the note body.