← All posts

matcha now syncs with Notion.

Lots of students already keep their homework in Notion: a database of assignments with due dates, a checkbox for done, maybe a column for the class. Until now, getting that into matcha meant copying it over by hand. Not anymore. Connect Notion, point matcha at your task database, and everything in it lands in your study plan.

How to connect

  1. In matcha, open your profile, go to Connections, and press Connect next to Notion.
  2. Notion asks which pages to share with matcha. Choose the database where you keep your assignments or tasks.
  3. Back in matcha, open your Notion settings and pick that database as your Task database.
  4. Match its columns: the task name, the due date, and the checkbox or status that marks a task as done.
  5. Press Sync. Your tasks import and matcha plans study sessions for them straight away.

Don't see your database? In Notion, open the database page, click ••• in the top right, then Connections, then Add connections, and choose Matcha. Then press Refresh databases.

Your columns, your setup

Every Notion workspace is set up differently, so matcha doesn't guess. You tell it which column holds what. Only the task name is required. Beyond the due date and done status, you can also map:

  • Duration: a number column with how many minutes a task takes.
  • Subject or course: a class, subject tag or relation.
  • Priority, description and assignment type, like Homework, Exam or Reading.

Check it off anywhere

Two-way completion sync is on by default. Check a task off in matcha and it's marked done in Notion. Complete it in Notion and matcha updates too. Either way, finished work stops getting study sessions. If you'd rather matcha never touched your Notion, turn two-way completion sync off in settings.

Staying in sync

  • Automatic: while matcha is open, it checks Notion every few minutes, or on the schedule you pick: every 30 minutes, hourly, every 6 hours, daily or only when you ask.
  • When you come back: matcha refreshes Notion when you return to the app. You can turn this off.
  • Right now: press Sync any time.
  • Your call: turn off Show in planner to keep Notion tasks out of your schedule without disconnecting.

Your data stays yours

  • matcha can only see the databases you share with it in Notion.
  • Your Notion access is encrypted before it's stored.
  • You can disconnect any time, which revokes matcha's access. Tasks that already imported stay in your planner until you remove them.

Good to know

  • Works with everything else: Notion tasks sit in the same plan as your Canvas or StudentVUE assignments, your Todoist tasks and your Google Calendar.
  • Cost: matcha is free.