https://github.com/seba-1511/sync-paperpile-notion

Sync changes in Paperpile to a Notion database.
https://github.com/seba-1511/sync-paperpile-notion

notion paperpile

Last synced: 2 months ago
JSON representation

Sync changes in Paperpile to a Notion database.

• Host: GitHub
• URL: https://github.com/seba-1511/sync-paperpile-notion
• Owner: seba-1511
• License: apache-2.0
• Created: 2022-08-29T02:08:13.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-08-30T00:05:23.000Z (over 2 years ago)
• Last Synced: 2024-11-30T11:41:39.610Z (2 months ago)
• Topics: notion, paperpile
• Language: Python
• Homepage:
• Size: 12.7 KB
• Stars: 14
• Watchers: 4
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# sync-paperpile-notion

Sync changes in Paperpile to a Notion database.

## Setup

### On Notion

1. Create a new database (e.g. "Papers") with the columns named exactly:

    1. `Title` of type title.

    2. `Authors` of type text.

    3. `Year` of type text.

    4. `Link` of type url.

    5. `Reference ID` of type text.

2. Get the **database identifier** from the database page. If your database url is:

    ```

    https://www.notion.so/my_workspace/aaaabbbbccccddddeeeeffffgggghhhh

    ```

    Then the database identifier is: `aaaabbbbccccddddeeeeffffgggghhhh`.

3. Create a new integration on [https://www.notion.so/my-integrations/](https://www.notion.so/my-integrations/).

    1. Name: Paperpile to Notion

    2. Associated Workspace: Workspace of the database.

    3. Content Capabilities: Read Content, Update Content, Insert Content.

    4. User Capabilities: Read user information, including email addresses.

    5. Press "Submit" and copy the **Internal Integration Token**.

4. On the database page, click "Share" (top right) and add "Paperpile to Notion" with edit access.

### On GitHub

1. Fork this repository with the green "Use this template" button.

2. On you fork, go to: "Settings -> Secrets -> Actions".

3. Create 2 new repository secrets named exactly:

    

    1. `NOTION_TOKEN`: Your integration's internal integration token, from step 3.5 above.

    2. `DATABASE_IDENTIFIER`: Your database identifier, from step 2 above.

### On Paperpile

1. Click on the top-right gear, go to "Workflows and Integrations".

2. Follow the instructions to add a new "BibTex Export", choosing:

    1. Your GitHub repository fork as the repository.

    2. `references.bib` as the export path.

The first sync should start as soon as the Paperpile workflow is created, and subsequent syncs are triggered whenever papers are added or updated in your Paperpile.

**Note**

The first sync might take some time as Notion limits the API rate to ~ 3 requests / second; so if you have 1,000 papers it'll take ~ 6 minutes before they are all available in Notion.