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.

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

4. Click Install.

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

6. Click Options.

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.

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.

2. Click start task.

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

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.

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

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.

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.

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.

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

