AlfreDo

An Alfred Workflow for Todoist.

NOTE: app not created by, affiliated with, or supported by Doist.

• Motivation
• Setting up
• Basic Usage
• Known Issues
• New features in version 0.5
• Acknowledgments
• Changelog
• Feedback

Motivation ✅

• Quickly list, search, and act on your Todoist tasks
• Add new tasks to Todoist through Alfred

Setting up ⚙️

Needed

• Alfred 5 with Powerpack license
• A Todoist account
• Download AlfreDo latest release

Default settings

• In Alfred, open the 'Configure Workflow' menu in AlfreDo preferences
  • set the Todoist API token (login into your account, then generate it here)
• Optional:
  • set the keyword (or hotkey) to show:
    1. Tasks due today (default: !1)
    2. Overdue (default: !2)
    3. All tasks (default: !3)
    4. Tasks with a deadline (default: !4)
    5. New task (default: !!!)
  • set the keyword (or hotkey) to force-refresh (default: todoist::refresh)
  • set the keyword (or hotkey) to create a new task (default: !!!)
  • set refresh rate (in days). Default: 1
    • Recommended 0 (refresh every time) or 1 if you use Todoist often from browser, mobile etc.
    • Database is automatically refreshed when a task is created, completed, or rescheduled.
    • Refresh can be forced using a keyword (default: todoist::refresh) or hotkey.
  • show Karma daily and weekly goals? Default: yes
  • partial match search? Default: yes. Search projects and labels anywhere in the string. Will search from start if unchecked
  • open task in Todoist app, or website

Basic Usage 📖

Searching your tasks 🔍

• launch with keyword or custom hotkey. You can start from 1) tasks due today, 2) tasks overdue, 3) all tasks, or 4) tasks with a deadline.
• Use multiple strings, or label/projects to refine search. Use @ to enter one or more labels, # to enter a project/section.
• Once a task is selected, you can do one of five things:
  1. enter ↩️ will open the task on Todoist (default) or in the Todoist app, based on user preference set in Configure Workflow
  2. shift-enter ⇧↩️ will complete the task
  3. ctrl-enter ^↩️ will open a menu to reschedule the task. Choose one of the preset options, or enter a date in international format, with (YYYY-MM-DDTHH:MM) or without (YYYY-MM-DD) time, or enter a number of days. You can also use w or m after the number to enter weeks and months, respectively (e.g. 10w will reschedule in 10 weeks). Time (in 24h format) can be added after these shortcuts as well (e.g. 7w13:13). Natural language dates are also supported (e.g. tomorrow, next friday).
  4. alt-enter ⌥↩️ will open the task for editing. The current task content, labels, project, priority, due date, and deadline are pre-populated in the input field. Modify any attribute using the same syntax as task creation, then press shift-enter ⇧↩️ to save.
  5. ctrl-alt-cmd-enter ⌃⌥⌘↩️ will delete the task immediately (no confirmation)

Creating new tasks ⭐

• launch with keyword (default: !!!) or hotkey.
• Use:
  • @ to enter one or more labels (new ones can be created on the fly)
  • # to enter a project/section (Inbox will be used if none entered)
  • p[1-4] to enter a priority
  • due: to enter a due date. Choose one of the preset options, or enter a date in international format, with (YYYY-MM-DDTHH:MM) or without (YYYY-MM-DD) time, or enter a number of days. You can also use w or m after the number to enter weeks and months, respectively (e.g. 10w will set a due date in 10 weeks). Time (in 24h format) can be added after these shortcuts as well (e.g. 7w13:13). Natural language dates are also supported (e.g. due:tomorrow, due:next friday)
  • {deadline} to set a deadline using curly braces: {YYYY-MM-DD}, or relative expressions like {7d}, {3w}, {2m}. Natural language deadlines are also supported: {next friday}, {tomorrow}
  • for ... to set a task duration in natural language (e.g. for 30 minutes, for 45 mins, for 2h, for 2h15m). The duration is only applied when the task also has a due date with a time (e.g. do something tomorrow at 5pm for 30 minutes). English only.
• Task Stamp: optionally add a description to every new task. Set the TASK_STAMP variable in the Workflow Configuration to a template string. Use {timestamp} as a placeholder for the current date and time (e.g. Created {timestamp} → Created Sunday, February 8, 2026, 12:40:23 pm). Leave empty to skip.
• Universal Action: new tasks can be created by selecting text in any app, then launching Universal Actions and selecting Create a new Todoist task.

Editing tasks ✏️

• Select a task from any query view, then press alt-enter ⌥↩️ to edit it
• The current task content, labels, project, priority, due date, and deadline are pre-populated in the input field
• Modify any attribute using the same syntax as task creation (@label, #Project, p1–p4, due:, {deadline}), then press shift-enter ⇧↩️ to save

Database refresh 🔄

• will occur according to the rate in days set in AlfreDo preferences, after a task is created, completed, rescheduled, or deleted, or...
  • todoist::refresh to force database refresh

Limitations & known issues ⚠️

• None for now, but I have not done extensive testing, let me know if you see anything!

Acknowledgments 😀

• Thanks to the Alfred forum community!
• Icons from Flaticon:
  • https://www.flaticon.com/free-icon/overdue_6534474
  • https://www.flaticon.com/free-icon/calendar_6816638
  • https://www.flaticon.com/free-icon/project-management_4844342
  • https://www.flaticon.com/free-icon/task_2098402
  • https://www.flaticon.com/free-icon/check_10308323
  • https://www.flaticon.com/free-icon/bowler-hat_3345848
  • https://www.flaticon.com/free-icon/new_3634451
• Thanks to Werner Dijkerman for help with troubleshooting.

New features in version 0.5

🆕 Version 0.5 is a complete rewrite in Go, bringing several new features:

Delete tasks 🗑️

• Select a task from any query view, then press ctrl-alt-cmd-enter ⌃⌥⌘↩️ to delete it immediately (no confirmation)

Edit tasks ✏️

• Select a task from any query view, then press alt-enter ⌥↩️ to edit it
• The current task content, labels, project, priority, due date, and deadline are pre-populated in the input field
• Modify any attribute using the same syntax as task creation, then shift-enter ⇧↩️ to save

Deadlines 🎯

• Set a deadline when creating or editing a task using curly braces: {YYYY-MM-DD}, or relative expressions like {7d}, {3w}, {2m}
• Natural language deadlines are also supported: {next friday}, {tomorrow}
• New deadline query mode to view only tasks with deadlines, sorted by closest deadline
• Deadline info is displayed in task subtitles across all query modes

Natural language dates 🗓️

• Due dates and deadlines support natural language expressions: due:tomorrow, due:next monday, {in 3 weeks}
• Inline date detection: simply type buy milk tomorrow or meeting next friday at 3pm — dates are recognized automatically from the task content
• Multi-language support: dates are resolved locally based on your system language (LANG environment variable). Supported languages: Danish, Dutch, English, Finnish, French, German, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Swedish, Turkish, Chinese
• Examples: due:domani (Italian), due:morgen (German), {demain} (French), nachsten freitag (German, "next Friday")
• Multi-word expressions with "next" prefixes are supported (e.g., venerdì prossimo, nächsten Freitag, próximo lunes)
• Rescheduling also supports natural language input
• All dates are resolved locally to YYYY-MM-DD format before being sent to the Todoist API

Task Stamp 📝

• Automatically add a description to every new task by setting TASK_STAMP in the Workflow Configuration
• Supports a {timestamp} placeholder that gets replaced with the current date and time (e.g. Created {timestamp} → Created Sunday, February 8, 2026, 12:40:23 pm)

No more Python dependency 🐍➡️🐹

• AlfreDo now runs as a compiled Go binary — no need for Python3

Changelog 🧰

• 02-07-2026: version 0.5 -- complete rewrite in Go, new features (edit tasks, deadlines, natural language dates), and bug fixes
• 05-20-2024: version 0.4.1 -- bug fix
• 02-13-2024: version 0.4 -- new features and bug fixes (listed here)
• 11-10-2023: version 0.3 -- support for app, bug fixes
• 06-10-2023: version 0.2.2 -- support for sections, international date, time, supporting spaces in project names
• 05-03-2023: version 0.1

Feedback 🧐

Feedback welcome! If you notice a bug, or have ideas for new features, please feel free to get in touch either here, or on the Alfred forum.