External Integrations
Let other apps drive PrimeTask - and embed deep links back to your other apps anywhere in PrimeTask. A two-way bridge between your toolset.
PrimeTask integrates with the rest of your toolset through deep links, in both directions:
- Other apps can drive PrimeTask through PrimeTask's own
primetask://URL scheme - from Apple Shortcuts, Alfred, Raycast, a terminal command, or any tool that can open a URL. - PrimeTask can embed deep links to your other apps - Obsidian notes, Figma files, Linear issues, VS Code files, Spotify playlists, Slack channels - in task notes, project notes, and on PrimeFlow canvases.
The result: your toolset talks to itself. Your calendars don't stay in isolation. Your notes don't stay in isolation. Your research lives next to the task that needs it, and the task is one click from every tool you use to get it done.
For the Integrations category hub, see Integrations Overview.
Opt-in by default
Deep link commands are disabled until you enable them. Each command type can be individually allowed or blocked, and every command that runs is written to an audit log you can review.
What you can do
Drive PrimeTask from another app
Apple Shortcuts, Alfred, Raycast, terminal, email, or anything else that can open a URL.
Create tasks
Copy a link
to any task, project, contact, or company and paste it into Obsidian, Craft, Notion, email - and that link will open PrimeTask at that exact entity.
Embed deep links to other apps inside PrimeTask
obsidian://..., figma://..., linear://..., spotify:..., slack://... into a task note or project note, and it becomes a clickable link that opens that app at the right spot.Use the External App node
in PrimeFlow to place a deep link as a canvas node connected to the work it belongs to.
Outbound - other apps drive PrimeTask
PrimeTask registers the primetask:// URL scheme on your operating system. Any tool that can open a URL can trigger PrimeTask - create a task, start a timer, open a project, jump to a page.
The URL format is always the same:
primetask://category/action?spaceName=YourSpace¶m=valueEvery command carries a Space name (or Space ID) so it always targets the right Space, even when PrimeTask is minimised or you have several Spaces open.
Space name is always required
Every command must include spaceName (or spaceId). This prevents a command from accidentally running against the wrong Space.
Task commands
- Create a task -
primetask://task/create?spaceName=Personal&title=Buy%20groceries&priority=high
- Parameters: spaceName (required), title (required), description, priority (low / medium / high / urgent)
- Complete a task -
primetask://task/complete?spaceName=Work&taskId=task-abc123 - Start a task (set to In Progress) -
primetask://task/start?spaceName=Work&taskId=task-abc123 - Open a task -
primetask://task/open?spaceName=Work&taskId=task-abc123
Timer commands
- Start the timer on a task -
primetask://timer/start?spaceName=Work&taskId=task-abc123 - Stop the running timer -
primetask://timer/stop?spaceName=Work - Toggle the timer on a task -
primetask://timer/toggle?spaceName=Work&taskId=task-abc123
Navigation commands
Open any PrimeTask page directly:
primetask://nav/tasks?spaceName=Workprimetask://nav/calendar?spaceName=Workprimetask://nav/projects?spaceName=Workprimetask://nav/dashboard?spaceName=Workprimetask://nav/primeflow?spaceName=Workprimetask://nav/reports?spaceName=Workprimetask://nav/crm?spaceName=Work(Pro with CRM enabled)primetask://nav/settings?spaceName=Work
Open a specific entity
- A project -
primetask://project/open?spaceName=Work&projectId=proj-abc123 - A contact (Pro) -
primetask://crm/openContact?spaceName=Sales&contactId=contact-abc123 - A company (Pro) -
primetask://crm/openCompany?spaceName=Sales&companyId=company-abc123
Copy Link - the fastest way to get a link
Right-click any task, project, contact, or company and pick Copy Link. PrimeTask copies a primetask:// URL for that entity to your clipboard. Paste it in Obsidian, Craft, Notion, email, or anywhere that takes a link - clicking it opens PrimeTask at that exact entity.
Copy Link appears in right-click menus only when External Integrations are enabled.
Use Copy Link to stitch your notes to your tasks
Paste task links inside your Obsidian notes, your Craft docs, your Notion wiki. When the note references the task, one click opens the task in PrimeTask - without a fragile search.
Inbound - PrimeTask embeds deep links to your other apps
The same idea runs the other way. PrimeTask accepts any URL scheme - not just http:// or https://. Paste a deep link to another app and PrimeTask treats it as a clickable link that opens that app at the right spot.
In task notes
Open a task's notes editor and paste a deep link like:
obsidian://open?vault=Work&file=Q2-Planfigma://file/abc123/Design-Systemlinear://team/ENG/issue/ENG-142vscode://file/Users/you/project/src/App.tsxspotify:playlist:...slack://channel?team=...&id=...
The paste becomes a clickable link. Click it and the other app opens to that exact note, file, issue, or channel.
For the full task notes workflow, see Task Notes.
In project notes
Project notes work the same way. Paste any deep link and it becomes an inline clickable reference to the other app. Use this to keep a project's research, design file links, ticket links, and documentation next to the project brief.
For the full project notes workflow, see Project Notes.
On a PrimeFlow canvas
For a visual layout instead of inline notes, drop an External App node in PrimeFlow. Paste the deep link in the node configuration; the node becomes a clickable launcher you can connect to tasks, projects, and records on the canvas.
See PrimeFlow External App Nodes.
Don't just link to the app - link to the spot
A sticky with "Figma →" is useful once. A node that opens this specific file in Figma is useful every time. Deep links are always the better choice when the app supports them.
Apple Shortcuts, Alfred, Raycast
The outbound story pairs perfectly with automation tools - triggering PrimeTask from a keyboard shortcut, a menu bar item, Siri, or time/location triggers.
Apple Shortcuts
Step 1
Open the Shortcuts app (macOS includes it).
Step 2
Create a new shortcut and add the Open URLs action.
Enter a `primetask://` URL
for example, primetask://task/create?spaceName=Personal&title=Quick%20Task.
Step 4
Save with a name you'll remember; add an Ask for Input action beforehand and reference that input in the URL when you want dynamic titles.
See Apple Shortcuts and Deep Links for detailed recipes.
Alfred
Create a new workflow with a Keyword Input connected to an Open URL action. Use {query} in the URL for dynamic task titles.
Raycast
Create a Quicklink with the PrimeTask URL. Use {Query} for dynamic parameters.
Test from Terminal
You can test any primetask:// URL from your terminal:
open "primetask://task/create?spaceName=Personal&title=Test%20Task"
open "primetask://timer/stop?spaceName=Work"Security
- Opt-in per command type - enable only the commands you want to accept. Everything else is blocked.
- Space name required - every command must target a specific Space. No accidental cross-Space actions.
- Audit log - every external command that runs is written to the audit log, with timestamp and source. Review it any time.
- Copy Link is gated - the Copy Link action only appears in right-click menus when external integrations are enabled.
See External Integrations Settings for the full set of toggles and the audit log viewer.
How to enable
Step 1
Open Settings → External Integrations.
Step 2
Enable External Integrations.
Step 3
Allow the specific commands you want to use. Leave the rest disabled.
Step 4
The Copy Link action appears in right-click menus once External Integrations are on.
Things worth knowing
Outbound and inbound are independent
The outbound primetask:// scheme and the inbound "paste other apps' deep links into notes" feature are separate. You can use either without the other. Most users turn on both.
Deep links to other apps don't require enabling anything in PrimeTask
Pasting obsidian:// or figma:// into a task note works as soon as you paste. There's no separate toggle - it's just how URLs work in PrimeTask's notes.
Works on macOS and Windows
The primetask:// scheme is registered on both platforms. Outbound deep links to other apps work wherever the target app is installed and supports its own URL scheme.
Copy Link never exposes sensitive data
A PrimeTask copy link is a URL that opens PrimeTask at an entity. It doesn't include the entity's content or any of your data - just the reference.
Common questions
"Can I automate capturing a task from Siri?"
Yes - create an Apple Shortcut that opens a primetask://task/create?... URL, and trigger the shortcut with Siri, a keyboard shortcut, or a widget. See Apple Shortcuts and Deep Links.
"Why doesn't Copy Link show in my right-click menu?"
External Integrations must be enabled in Settings first. Once enabled, Copy Link appears on tasks, projects, contacts, and companies.
"Can I paste any kind of deep link into task notes?"
Yes. PrimeTask treats anything that looks like a URL scheme as a clickable link. Your operating system opens it using whichever app is registered for that scheme.
"What happens if I click a deep link and the target app isn't installed?"
Your operating system handles it - usually a prompt to install the app, a browser fallback if the target supports one, or an error. PrimeTask isn't affected by the result.
"Does this require Pro?"
No. External Integrations are available on every PrimeTask license. A few specific commands (CRM open, CRM nav) require Pro because they touch Pro features, but the integration surface itself is not gated.
"Can I undo a command that ran?"
Commands are regular actions in PrimeTask. If a task was created, you can delete it. If a timer was started, you can stop it. The audit log shows what ran and when so you can trace anything unexpected.
Where to go next
| If you want to… | Read this |
|---|---|
| Build Apple Shortcuts recipes | Apple Shortcuts and Deep Links |
| Place deep links as canvas nodes | PrimeFlow External App Nodes |
| Embed deep links in task notes | Task Notes |
| Embed deep links in project notes | Project Notes |
| Configure command toggles and audit log | External Integrations Settings |
| Connect AI agents (MCP) | Bring Your Own AI |