arxiv2notion

Supported Format

Easy-to-use arXiv clipper for Notion based on Notion API

⬇️ Installation

a. Install via Chrome Store

• arxiv2notion is now available at Chrome Store 🚀.

b. Install Manually

• download extension package from https://github.com/denkiwakame/arxiv2notion/releases/latest
• for Chrome, navigate to chrome://extension
• drag and drop the extension from your file manager anywhere onto the extensions page
• or unzip the extension and load unpacked in developer mode

⚙️ Setup

1. Add arxiv2notion integration

• navigate to My Integrations
• + New Integration
• associated workspace: select your workspace where you save arXiv articles
• Type: select Internal
• name: set any name of your choice

[!NOTE] For more detailed information about Notion integration, please refer to the official documentation at https://developers.notion.com/docs/getting-started.

2. Configure the extension

• right-click on the extension icon > Options
• copy integration id (not the secret token!) (see figures below) from https://www.notion.so/my-integrations/internal/${integration-id}
• paste the integration id and click on + button.
• if your entered id is valid, you can see the following callback messages.

[!NOTE] To enhance security, arxiv2notion retrieves the Notion API key (integration secrets) on-demand through integration ID instead of storing it directly in Chrome local storage. Please ensure you are logged into notion.so while using this extension.

3. Create databases in Notion

from template (recommended)

• clone the public template here to your own notion workspace
• add connection to target databases via ... > (scroll down...) Connect to > {your integration name}

• Integration will have access writes to all child DBs.

or manually

• alternatively, you can follow the following steps to create database from scratch in notion
• login to notion.so by admin user
• create databases where you save arXiv articles
• follow this instruction https://www.notion.so/guides/creating-a-database and add properties listed below.

[!CAUTION] Do NOT create a new database by /database ! Make sure to create properties with exactly the same names and types as those listed.

property	type
Title	Title
URL	URL
Authors	Multi-Select
Abstract	Text
Published	Date
Comments	URL
Publisher	Select

[!NOTE] migration from v0.1.x → v1.0.0 - We changed Authors type and added Published Comments property from v1.0.0. - Change your existing database properties as follows, you can easily integrate new features to your existing Notion database!

property	type(^v0.1.x)	type(v1.0.0+)
Authors	Text	Multi-Select
Published	--	Date
Comments	--	URL

[!TIP] You can add extra columns of your choice alongside the default ones in your databases.

:bulb: w/ Notion Formula (optional)

• Notion Formula allows you to add custom autofill property defined by formula.
• For instance, replace(URL, "arxiv", "ar5iv") formula adds an ar5iv link column by substituting "arxiv.org" with "ar5iv.org" 🚀

:bulb: w/ Notion AI Property (optional)

• Notion AI Property allows you to add custom autofill property to each DB record.
• Add column to your Notion DB and select AI custom autofill
• Set any prompt you like (e.g. summarization, extracting key ideas ...)
• Save an article via arxiv2notion ,and then the preset AI property will be automatically generated.

:technologist: Build locally (for Developers)

• See also CONTRIBUTING.md

$ git clone https://github.com/denkiwakame/arxiv2notion.git
$ npm install
$ npm run build
$ npm run watch # debug locally
$ npm run pack  # packaging to zip

Contributors

• Maintainers: @denkiwakame, @wangjksjtu