Automate Your Tasks with Deep Linking

Create tasks, open lists, and navigate TaskForge from any app using the taskforge:/// URL scheme. Integrate with Obsidian, Apple Shortcuts, Raycast, Alfred, Tasker, and any tool that supports custom URLs.

Works on iOS, Android & macOS

30+ configurable parameters

Integrates with any URL-capable app

TaskForge registers the taskforge:// custom URL scheme on all platforms. Deep links use a triple slash (///) and work on iOS, Android, and macOS.

taskforge:///[path]?[parameters]

Note the triple slash (///). This is the standard format across all platforms.

Available Routes

TaskForge supports the following navigation routes. Each route opens a specific screen in the app.

Home

Opens the home screen.

taskforge:/// or taskforge:///home

Custom List

Opens a specific custom list by name. The list name is a path parameter and must be URL-encoded.

taskforge:///list/My%20List

Task Detail

Opens a specific task by its ID. Get a task's deep link by tapping the link icon in the Task Detail screen.

taskforge:///task/abc123def456

Calendar

Opens the calendar view. Optionally provide a date in YYYY-MM-DD format as a path segment.

taskforge:///calendar or taskforge:///calendar/2025-03-15

Quick Add

Opens the quick add dialog with natural language parsing. Optionally add ?listId=uuid to target a specific list.

taskforge:///quick-add

New Task

Opens the new task screen. Supports query parameters to pre-fill fields (see parameter reference below).

taskforge:///new-task

Search

Opens the home screen with the search bar active.

taskforge:///?search=true

Settings

Opens the settings screen.

taskforge:///settings

Deep Link Reference

Opens the in-app deep link reference screen with all supported routes.

taskforge:///settings/deep-links

New Task Parameters

The /new-task route accepts the following query parameters. All parameters are optional, omitted fields use your configured defaults.

Task Properties

Parameter	Format	Example	Description
`name`	URL-encoded string	`name=Buy%20groceries`	Task title
`tags`	Comma-separated	`tags=work,urgent`	Task tags
`contexts`	Comma-separated	`contexts=home,office`	Task contexts
`projects`	Comma-separated	`projects=Website,Mobile`	Task projects
`listId`	UUID string	`listId=abc-123-def`	Assign to a custom list

Dates (ISO 8601: YYYY-MM-DD)

Parameter	Example	Description
`dueDate`	`dueDate=2025-03-15`	Due date
`scheduledDate`	`scheduledDate=2025-03-10`	Scheduled date
`startDate`	`startDate=2025-03-01`	Start date
`completedDate`	`completedDate=2025-03-20`	Completed date

Priority

Values are case-insensitive.

Highest, High, Medium, Low, Lowest, None

Status

Values are case-insensitive.

todo, done, cancelled, inProgress, onHold, planned, deferred, blocked, someday, ready

On Completion

What happens when the task is completed. Values are case-insensitive.

keep, delete, archive

Skipping User Defaults

Suppress specific user defaults without providing a replacement value. Useful for creating blank tasks from automations.

_skipTags=1 _skipDueDate=1 _skipScheduledDate=1 _skipStartDate=1 _skipDueTime=1 _skipPriority=1 _skipStatus=1 _skipReminders=1 _skipOnCompletion=1 _skipContexts=1 _skipProjects=1 _skipScheduledTime=1 _skipStartTime=1

Full Examples

Simple task with a due date

taskforge:///new-task?name=Buy%20groceries&dueDate=2025-03-15

Work task with tags, priority, and time

taskforge:///new-task?name=Review%20PR&tags=work,code-review&priority=High&dueDate=2025-03-15&dueAt=10:00

Recurring weekly task

 taskforge:///new-task?name=Team%20Standup&recurrenceInterval=1&recurrenceUnit=week&recurrenceSpecificDayOfWeek=1&dueAt=09:30

Task with all defaults suppressed

taskforge:///new-task?name=Quick%20Note&_skipTags=1&_skipDueDate=1&_skipPriority=1&_skipReminders=1

Task assigned to a custom list

taskforge:///new-task?name=Sprint%20Task&listId=abc-123-def&tags=sprint&priority=Medium

Open calendar to a specific date

taskforge:///calendar/2025-12-25

Quick add to a specific list

taskforge:///quick-add?listId=abc-123-def

Deep Linking with Obsidian

Obsidian supports custom URL schemes in markdown links, making it the perfect companion for TaskForge deep links. Add clickable links in your notes that create tasks, open lists, or navigate directly to specific views in TaskForge.

Markdown Links in Notes

Use standard markdown link syntax in your Obsidian notes to create clickable deep links:

Create a follow-up task from meeting notes

[Add follow-up task](taskforge:///new-task?name=Follow%20up%20on%20meeting&tags=work&dueDate=2025-03-20)

Quick link to your work list

[Open Work Tasks](taskforge:///list/Work%20Tasks)

Open today's calendar view

[Today's Calendar](taskforge:///calendar/2025-03-15)

Quick add with natural language

[Quick Add Task](taskforge:///quick-add)

Obsidian Workflow Ideas

Meeting Notes Template

Add deep link buttons at the bottom of your meeting note template. After each meeting, click to create follow-up tasks with pre-filled tags and due dates.

Project Dashboards

Create an Obsidian note that serves as a project dashboard. Add links to open the corresponding TaskForge list, create new project tasks, or view the calendar for project deadlines.

Daily Notes Integration

Add deep links to your daily note template. Include a link to open today's task list, quick add for capturing ideas, and calendar view for schedule overview.

Weekly Review Template

Build a weekly review template with deep links to create the next week's recurring tasks, open your review list, and navigate to the calendar for planning.

Integrations with Other Apps

TaskForge deep links work with any app or tool that can open custom URL schemes. Here are popular integrations across platforms.

Apple Shortcuts (iOS / macOS)

Create powerful automations with the Shortcuts app. Use the "Open URL" action with TaskForge deep links to create tasks with Siri, trigger time-based automations, or build location-aware workflows.

Add an "Open URL" action and set the URL to taskforge:///new-task?name=My%20Task&tags=work&priority=High. Name the shortcut and trigger it with "Hey Siri, [shortcut name]".

Combine with Shortcuts variables to dynamically build task names from clipboard content, calendar events, or user input.

Raycast (macOS)

Build custom Raycast commands that create tasks in TaskForge. Use the "Open URL" action with deep links for keyboard-driven task creation without leaving your current app.

Create a Raycast script command that opens taskforge:///new-task?name={query}&tags=inbox to capture tasks from anywhere on your Mac.

Use Raycast's argument support to pass dynamic task names directly from the search bar.

Alfred (macOS)

Build Alfred workflows that send tasks to TaskForge. Create custom keywords that accept arguments and pass them as URL-encoded parameters to TaskForge deep links.

Create a workflow with keyword "task" that opens taskforge:///new-task?name={query}&tags=alfred.

Use Alfred's "Open URL" action with dynamic arguments for quick capture.

Tasker (Android)

Automate TaskForge on Android with Tasker. Use the "Browse URL" action to open TaskForge deep links from Tasker profiles triggered by time, location, or events.

Create a Tasker profile that opens taskforge:///list/Work%20Tasks when you connect to your office Wi-Fi.

Combine with AutoInput or other Tasker plugins for advanced automation flows.

Keyboard Maestro (macOS)

Create macros that trigger TaskForge actions via deep links. Combine with text expansion, clipboard monitoring, or keyboard shortcuts for context-aware task creation.

Set up a hotkey macro that opens taskforge:///new-task?name=%CurrentClipboard%&tags=capture to create a task from your clipboard.

Perfect for creating tasks from selected text in any app.

IFTTT / Zapier / Make

Connect TaskForge to hundreds of web services. Use webhooks or URL actions to create tasks from email, calendar events, form submissions, or any trigger supported by these platforms.

Create a Zapier workflow that opens a TaskForge deep link when a specific label is added to a Gmail message.

Use URL-encoding functions in these platforms to safely pass dynamic data into deep link parameters.

Web Pages & Bookmarklets

Add TaskForge deep links to any web page or create browser bookmarklets for quick task creation. The link will open TaskForge on any device that has the app installed.

HTML: <a href="taskforge:///new-task?name=Review%20Document">Add Review Task</a>

Create a bookmarklet that captures the current page title as a task name.

Error Handling

Invalid parameters are silently ignored. The task is created without that field, falling back to user defaults.
Malformed dates (e.g., dueDate=not-a-date) are skipped; the field is left empty.
Invalid enum values (e.g., priority=SuperHigh) are skipped.
Invalid JSON in the reminders parameter is skipped.
Unknown routes fall back to the home screen.
Missing required data (e.g., /task/ without a task ID) falls back to the home screen.

Platform Support

iOS & macOS

The taskforge:// URL scheme is registered in the app's Info.plist. Deep links work from Safari, Shortcuts, Spotlight, and any app that can open URLs.

Android

The taskforge:// URL scheme is registered via an intent filter in AndroidManifest.xml. Deep links work from any app that can fire an ACTION_VIEW intent.

Frequently Asked Questions

Do deep links work on all platforms?

Yes. TaskForge deep links work on iOS, iPadOS, macOS, and Android. The taskforge:// URL scheme is registered natively on each platform.

Do I need to localize deep link parameters?

No. Deep link parameters are always in English regardless of your app language. Route paths, parameter names, and enum values like priority levels are always English. Free-form values like task names and tags can be in any language, just URL-encode them.

What happens if I use an invalid parameter?

Invalid or unrecognized parameters are silently ignored. The task is still created using your configured defaults for any missing fields.

Can I create tasks with reminders via deep links?

Yes. Reminders are passed as a URL-encoded JSON array using the reminders parameter. Each reminder object includes fields like type, relatedTo, and offset. See the in-app deep link reference for the full JSON format.

How do I get the list ID for the listId parameter?

Open the custom list editor in TaskForge and tap the link icon. The deep link URL will contain the list identifier you can use with the listId parameter.

Can I use deep links with Obsidian?

Absolutely. Add markdown links like [Create Task](taskforge:///new-task?name=My%20Task) directly in your Obsidian notes. Clicking the link will open TaskForge and create the task.

Start Automating Your Task Workflow

Download TaskForge and start using deep links to automate your Obsidian task management from any app.

Get Free - iOS & Mac

Get Free - Android

View All Features →