Paperpile Notion Integration

NOTE: This is a not an official Paperpile integration.

This is a Python CLI to manually sync your articles in Paperpile to a Notion database. Optionally, you may sync an authors database as well.

NOTE: This will only be maintained if Paperpile doesn't integrate directly with Notion. They have expressed interest, here.

This is a 🚧 work in progress. This isn't production-ready software, so it may be contain edge-cases not present in the BibTeX's we have tested. Please feel free to open issues if you encounter any bugs.

Usage

The documentation site contains a thorough walk-through to setup a GitHub-based sync service which just requires some initial configuration.

Installation

You can pip install paperpile-notion, preferably in a virtual environment.

pip install paperpile-notion

Requirements

To use paperpile-notion, you'll need a few things:

1. A JSON export from Paperpile. You can retrieve this by going to "Settings > Export > Export to JSON".
2. A configuration file, similar to what you'll find in docs/config.yml. Currently, we do not support venues, but it is planned.
3. Your Article database URL, which you can copy directly from your browser.
4. (optional) Your Author database URL, copied in a similar way as above.
5. Your token_v2 (detailed below) OR your email/password (never stored by paperpile-notion).

NOTE: Your Article database must have the following columns:

Usage

As we use notion-py, we are limited by their support for either an email/password login OR your TOKEN_V2. Your token_v2 may be retrieved from your [notion.so][notion] cookies.

1. Using your token_v2 (recommended)
2. Using your email/password

Using your token_v2 (recommended)

You have two ways to supply your token_v2 to paperpile-notion:

1. (preferred) You may store it in an environment variable called NOTION_TOKEN_V2, which will be read by paperpile-notion.
2. OR you may pass your token in using the --token <token_v2> flag.

# Using NOTION_TOKEN_V2
$ paperpile-notion update-db --refs <YOUR_JSON>.json

# Using --token ...
$ paperpile-notion --token <token_v2> update-db --refs <YOUR_JSON>.json

Using your email/password

You will be prompted each time for your Notion email/password login.

paperpile-notion update-db --refs <YOUR_JSON>.json

Example output

When adding, adding a new paper to the database:

Example resulting database on Notion: