Help · Calendar, contacts and tasks
Tasks
Updated
A to-do list next to your mail, and tasks made from emails with ⇧T.
Click Tasks in the sidebar, press g then k, or choose Mailbox › Go to Tasks (⌃⌘3). Type in Add a task and press Return. Click a task to add notes, a due date or a time, or to move it to another list.

Tasks are grouped by when they’re due: Overdue, Today, Tomorrow, Later and No date. Click the circle to mark one done. Done tasks fold away under Completed, where Delete completed tasks clears them out. The number next to Tasks in the sidebar is how many are due today or overdue.
A task that repeats (one made on your phone, say) shows a repeat icon. Ticking it moves it on to its next date, as Reminders does on iPhone.
Tasks in the calendar
The calendar’s week view shows your tasks above your events. The Tasks row has a column for each day, like a board, with a card for each task due that day. Tasks due at a time sit in the hours instead, outlined, next to that time’s events.

- Open a task: click its card. Its notes, due date, time and list open on the right.
- Change its text: double-click the card, or click its pencil, and type. Return saves; Escape leaves it as it was.
- Move it to another day: drag the card to that day’s column.
- Give it a time: drag it into the hours, to the time you want. Drag it to another time, or back up to the Tasks row to take the time away.
- Add a task: point at a day and click Add, or double-click an empty part of its column.
- Fold the row away: click Tasks on its left. Each day then shows how many tasks it has.
Tasks show only in your Mailroom. They aren’t added to your calendar as events, so people who can see your calendar, or check when you’re free, don’t see them. A task list on your calendar server can be seen by anyone you share that list with; On this Mac stays on this Mac.
Turn an email into a task
Select an email and press ⇧T (the same as in Gmail), or click Add to Tasks (the checklist button) in its toolbar. Change the title if you like, then pick when it’s due: no date, today, tomorrow, this weekend, next week, or a day of your own. Right-click an email and choose Add to Tasks to add it straight away, with no date.

The task keeps a link to the email: click it to open the email again. Select several conversations first to make a task for each.
Where tasks are kept
- On this Mac: a list that’s always there, kept only on this Mac.
- On your calendar server: if an account’s calendar connects over CalDAV and the server keeps to-dos too (Nextcloud does, for example), its task lists show in Tasks. Changes go both ways, so your phone sees them, and if a task changed in both places at once, both changes are kept.
Google Tasks, Microsoft To Do and Apple’s Reminders don’t use CalDAV, so they don’t show up yet.
Reminders
A task due at a time sends a notification then, while Mailroom is open. If Mailroom was closed, you get it when it next opens, as long as that’s within 12 hours. Turn reminders off in Settings › General › Notifications, and hide Tasks from the sidebar in Settings › Appearance.
Still stuck? or email support@getmailroom.dev. A person reads every message.