Connect Obsidian

Happy Squid Tasks enables you to block all unrelated websites and pages while working on a task. With the Happy Squid plugin for Obsidian, you can start a task from your notes in one click. When you finish it in the Happy Squid extension or app, the checkbox in your note is ticked automatically. Your task goal and a summary of your day can also appear right in your notes.

Set Up the Integration

You only do this once. Setting up the plugin takes about two minutes.

1. Make sure you have an active Happy Squid account. You need to be signed in on your computer in the Happy Squid browser extension or the desktop app. You'll find your email address in Happy Squid under Advanced settings, then Account.

2. In Obsidian, open Settings, choose Community plugins, and click Exit Restricted mode. You can skip this step if you already use community plugins.

Obsidian's settings open on Community plugins, with the Exit Restricted mode button highlighted.

3. Click Browse next to Community plugins, search for Happy Squid, and click the plugin.

Obsidian's Community plugins settings, with the Browse button highlighted.

4. Click Install.

The Happy Squid plugin in Obsidian's plugin directory, with the Install button highlighted.

5. Click Enable. Obsidian opens a note called Happy Squid that shows what the plugin can do.

The Happy Squid plugin after installing, with the Enable button highlighted.

6. Click Options.

The Happy Squid plugin after enabling, with the Options button highlighted.

7. Enter the email address of your Happy Squid account, click Send code, and type in the 6-digit code we email you. Then click Verify.

The Happy Squid plugin settings in Obsidian, with the email field and the Send code button highlighted.

Start and Finish Tasks from Obsidian

1. Write {task} at the end of any task in your notes. It turns into a start task button.

An Obsidian note called University with four tasks, the first of them ending in {task}, highlighted.

2. Click start task.

The University note, with the start task button next to Study aerodynamics for the exam highlighted.

3. Your task appears in Happy Squid within a few seconds, and the button in your note changes to stop task.

Happy Squid with the running task Study aerodynamics for the exam highlighted above the blocks for instagram.com and youtube.com.

4. When you're done, tick the checkbox. The task in Happy Squid ends within a few seconds. Clicking stop task ends the task too, but leaves the checkbox open.

The University note with Study aerodynamics for the exam running, its checkbox highlighted.

5. You can also finish your task in Happy Squid. Click the ✓ next to your task.

Happy Squid with the running task Email the tutor about the lab report, its check mark button highlighted.

Add Your Task Goal and Daily Summary

1. Write {taskgoal} on a line of its own in your daily note. It shows how far along you are with your task goal. Click the card to see the tasks you worked on that day.

An Obsidian daily note showing the daily task goal card, highlighted, above the Daily Summary card.

2. Write {daysummary} to see how long you worked on tasks, how much free time you used, and how often Happy Squid blocked you that day.

The Daily Summary card, highlighted, showing the day's time on tasks, free time, and blocks.

Shortly after you write a marker, Happy Squid adds today's date to it, so {taskgoal} becomes {taskgoal:2026-09-28}. Your note keeps showing that day, even when you open it a year later.

Use a Template for Your Daily Notes

If you create your daily notes from a template, don't put {taskgoal} in the template. It would get the date of the day you write the template, and every note you create from it would show that same day.

1. In your template, write {taskgoal:template} and {daysummary:template}. The template itself shows today's cards, so you can see what your daily notes will look like.

2. Create a new note from the template. The markers in the new note get the date of the day you create it: on 28 September 2026, {daysummary:template} becomes {daysummary:2026-09-28}.

This works when the template creates a new note, as Obsidian's Daily notes plugin does. If you insert a template into a note that already exists, its markers stay as they are and keep showing today.

Show Another Day

To show an earlier day, write its date into the marker, for example {taskgoal:2026-09-01}. To always show the current day, for example in a note you keep open, write {taskgoal:today}.

Disconnect Happy Squid

1. In Obsidian, open Settings, choose Happy Squid under Community plugins, and click Log out.

The Happy Squid plugin settings in Obsidian, with the Log out button highlighted.

2. To remove the plugin too, choose Community plugins, click ⋯ next to Happy Squid, and choose Uninstall.

Obsidian's Community plugins settings, with the Happy Squid plugin's uninstall button highlighted.