URL Scheme

The desktop app registers a taskdn:// URL scheme, letting you open tasks, projects, and views from other applications. This is useful for linking your notes to specific tasks, creating quick-capture workflows, or building automations. You might use this in circumstances where you don’t want to open the app directly from elsewhere:

• Obsidian notes — Link directly to a task you’re discussing in a meeting note or project document
• Alfred/Raycast — Create a global hotkey that captures a task without opening the app first
• Browser bookmarks — Quick links to your Today or Inbox view
• Calendar apps — Link calendar events to related tasks

Tip

The Obsidian plugin has a setting to automatically add a small link icon next to each task it renders. Clicking this link opens the task in the desktop app using the URL scheme.

Opening Things

Use taskdn://open to jump to a specific task, project, area, or view. Navigate directly to one of the main views:

taskdn://open?view=today
taskdn://open?view=inbox
taskdn://open?view=this-week
taskdn://open?view=calendar

Open a specific file by its path. The path must be URL-encoded:

taskdn://open?path=%2FUsers%2Fdanny%2Fnotes%2Ftasks%2Ffix-login-bug.md

When you open a task, the app navigates to the appropriate view (its project, area, or inbox) and selects it. Projects open in Project view, areas in Area view.

Tip

Don’t worry about encoding paths manually. Right-click any task, project, or area in the app and select Copy Local URL to get a ready-to-use link.

Creating Tasks

Use taskdn://new to create a task and open it for editing - all parameters are optional. You might use this to create a task from another tool:

taskdn://new?title=Buy%20milk

Assign to an existing project (matched by title, case-insensitive), or assign dates:

taskdn://new?title=Update%20landing%20page&project=Website%20Redesign
taskdn://new?title=Submit%20expenses&due=2025-01-31
taskdn://new?title=Weekly%20review&scheduled=2025-01-20

You can include URL-encoded body content (newlines are %0A) like this:

taskdn://new?title=Call%20Sarah&body=Discuss%3A%0A-%20Project%20timeline%0A-%20Budget

This creates a task with the body:

Discuss:
- Project timeline
- Budget

Practical Examples

Alfred/Raycast Quick Capture

Create a workflow triggered by a hotkey that prompts for text and creates a task:

open "taskdn://new?title={query}"

Link From Obsidian

In a meeting note, link to the task you’re discussing:

We agreed to prioritise [the login bug](taskdn://open?path=%2FUsers%2Fdanny%2Fnotes%2Ftasks%2Ffix-login-bug.md) this sprint.

Bookmark Your Daily View

Save this as a browser bookmark or add it to your dock:

taskdn://open?view=today

Full Reference

For complete documentation of all parameters, status values, and encoding rules:

URL Scheme Reference Complete technical reference for the taskdn:// URL scheme