This is a tutorial(?) to implement a Discord bot that is integrated with a Notion database, illustrated with the example notion-discord-book-recommendations.

P.S. Inspiration did not strike when I was naming the bot, any suggestions are very welcome 😂

What is this Bot?

Untitled

TLDR; I ramble about why this project exists

You’re at the right place, if you identify with any of the following

→ you have immediate enthusiasm for anything Notion-related (!!)

→ you have some working experience with Python

→ you spend half of every day on Discord, because suddenly it's a community centre, a symposium lobby, a water-cooler for idle talk, the medium of comms for all your gaming and whatever else rolled into one

So the Notion API was released to the public (in beta mode) recently, and I thought it would be a cool idea to make a working integration of Notion with Discord. So I first sparked, then fed off, the motivation of my friends - vaani98 and neutercrux - to actually finish this (somewhat). We worked for ten hours straight (lest the aforementioned motivation wear off) and made a Discord bot that ports book recommendations from text channels to a Notion database.

In this process, we ended up

→ learning how to make Discord bots and Notion integrations

→ using the Notion API and joining the newly abuzz community of Notion developers 🥺💕

→ making our first ever open-source contribution 🎉

Why not Automate.io

Automate.io already has a template for a Notion-Discord integration, which is super-easy to set up, for anyone interested in trying it out. The reasons we didn't just use this are

→ higher levels of functionality are behind a paywall

→ writing the code ourselves gave us the freedom to do a lot more cool stuff, because if we used an existing template

There'd be no scope for imagination then, would there? Anne of Green Gables

Requirements

  1. A Notion account