This simple application makes it possible to show items from multiple Notion database in your iCal calendar.
Before you can use this application you need to create an internal application within Notion. Read here how you can do that. Once you've created the integration, you can use the Internal Integration Token in order to authorize requests to the Notion API.
Besides a token you also need the ID of the Notion database you want in your calendar. You can find the ID in the last part of the database URL.
Example: https://www.notion.so/johndoe[pirlf9eefci9sey4l1gh7hsm0ur4wv2n]
The part in the URL between square brackets is the database ID
This application uses a config file named config.yml using YAML format to configure the Notion databases you want to turn into an iCal calendar.
calendars:
tasks:
name: Tasks
database_id: 63138270427139784081265724046142
properties:
date: Date
workouts:
name: Workouts
database_id: 39804639019819613784449002869425
properties:
date: DateThis application can be installed in two ways. The easiest way is probably using Docker
docker build -t notion-ical .
docker run -d -p 3000:3000 -v "$(pwd)/config.yml":/app/config.yml:ro -e NOTION_KEY=<notion API key> notion-icalIf you rather not use Docker and have Node.js and NPM installed, you can install the project using the following commands.
npm install # install dependencies
npm run compile # compile the source
npm run start # start the ical serverThis project was written using Typescript due to its type safety and easy integration with the Notion SDK for Javascript. When developing this application it can be cumbersome to continuously have to recompile the source code and start the server. Therefore you can use the following command which recompiles and restarts the application as soon as you make code changes.
npm run devThis project uses Google Typescript Style for simplicity sake. Anyone wishing to contribute to this project needs to make sure all linting rules pass before their PR's will be approved.