The author is explicit that this was built for one personal list: no custom fields, no recurring tasks, no priorities, and only today or later as scheduling. Taken as a starting point for your own Notion integration that is a virtue - the code is short enough to read in a sitting and change to match your database.
A deliberately small personal project. It manages a Notion todo database with exactly three properties - a Task title, a When select holding either today or later, and a completion checkbox - and nothing else.
- Add a new todo item
- View all todos, or just the ones scheduled for today
- Check a task off as complete
- A short, readable server file to fork when your own database looks different
Python 3.10 or higher, a Notion account, and a Notion integration whose API key goes in NOTION_API_KEY alongside the database ID in NOTION_DATABASE_ID. The database has to be shared with the integration from the Add connections menu, and it must match the three-property structure - anything else means editing the server file.
One command plus a key — uvx notion_mcp, then supply credentials