Automanotion

Why ?

This little project has for main purpose to back up the data from notion.

You can do a manual export of your Notion pages as HTML or Makdown. See https://www.notion.so/help/back-up-your-data

But I wanted to do it automatically every day without having to worry about it.

How ?

This application can be run directly with NodeJS or with Docker. It requires a Notion Token v2 to run.

Token v2

The token is a cookie stored in your browser when you are logged into notion.so. In order to find this token, follow these steps:

• In your browser, go to www.notion.so
• Make sure to be logged in
• If you're using Google Chrome, click on the lock (🔒) in the URL bar
• Click on Cookies
• Open www.notion.so and then Cookies
• You should find a cookie named tokenv2_
• Copy the value of the token

Node.js and NPM

Node.js and NPM needs to be installed. For windows see How to Install Node.js and NPM on Windows

npm install
TOKEN=[YOUR_TOKEN_v2] node app.mjs

See [environment variables](#Environment variables) section for options.

Docker

Docker can be used to run the backup application too.

Docker run

docker run -e TOKEN=[YOUR_TOKEN_v2] mremy/automanotion

See [environment variables](#Environment variables) section for options.

docker run -d \
--name=automanotion \
-e TOKEN=[YOUR_TOKEN_v2] \
-e TIMEZONE=Europe/Paris \
-e LOCALE=en \
-v /your/local/path:/home/node/data:rw \
mremy/automanotion

Docker compose

You can also use the docker-compose command.

Docker compose file example :

version: "3.9"

services:
  automanotion:
    image: mremy/automanotion
    volumes:
      - /your/local/path:/home/node/data:rw
    environment:
      LOCALE: "en"
      TIMEZONE: "Europe/Paris"
      # CRON: 0 */6 * * * (every 6 hours)
      # EXPORT_TYPE: html or markdown
      TOKEN: [YOUR_TOKEN_v2]

Environment variables

The only environment variable mandatory is the token

• TOKEN : your notion tokenv2
• CRON : task schedule with crontab syntax (default: no value => execute once)
• TIMEZONE: your timezone (default: Europe/Paris)
• LOCALE: your language code (default: en)
• EXPORT_TYPE: hmtl/markdown (if not specified both exports will be performed)

Cron Syntax

Cron syntax is something like that * * * * * *

This is a quick reference to cron syntax and also shows the options supported by the application.

 ┌────────────── second (optional)
 │ ┌──────────── minute
 │ │ ┌────────── hour
 │ │ │ ┌──────── day of month
 │ │ │ │ ┌────── month
 │ │ │ │ │ ┌──── day of week
 │ │ │ │ │ │
 │ │ │ │ │ │
 * * * * * *

Allowed values

• second: 0 - 59
• minute: 0 - 59
• hour: 0 - 23
• day of month: 1 - 31
• month : 1-12 (or names, e.g: Jan, Feb, March, ...)
• day of week: 0 - 7

Example

• Every 6 hours: 0 */6 * * *
• Every day at 00:00 0 0 * * *
• Every sunday at 00:00: 0 0 * * 0

Find other examples here

Acknowledgements

• ivanik7 project notion-backup which inspired this work
• Pageably on Where do I find my token to import a Notion page?
• Artur Burtsev on Automated Notion backups
• Steven S. Falcon on How To Build a Node.js Application in Docker
• Thomas Hammoudi with his Notion website and his YouTube channel on Notion