How to Add a Pomodoro Timer to Your Notion Dashboard

Notion is where a lot of people keep their tasks, goals, and daily plans. The problem is that your timer usually lives somewhere else — a separate tab you have to hunt for every time you want to start a session. The Tomatoro widget fixes that.

What you're embedding

The widget is a stripped-down version of Tomatoro built specifically for iframes. It has everything you actually use during a work session:

• The segment picker (focus, short break, long break)
• The big countdown and progress ring
• Today's harvest counter
• Start, pause, and reset

No header, no marketing, no distractions.

Step-by-step: adding it to Notion

1. Open the Notion page where you want the timer — your daily planner, your project dashboard, anywhere.
2. Type /embed and select Embed from the menu.
3. Paste this URL and click Embed link:

   https://tomatoro.com/widget
   

4. Drag the block's right edge until it's about 460 px wide. That's the natural width of the timer card.

That's it. The timer loads immediately — no login required.

Match the Notion light theme

Notion's default workspace is light. If you want the timer to match, add a theme parameter to the URL:

https://tomatoro.com/widget?theme=light

You can also use ?theme=dark for dark workspaces or ?theme=system to follow the viewer's OS setting (the default).

No account? No problem.

The widget runs entirely in the browser. Settings and today's progress live in local storage, so anyone who opens your shared Notion page gets a working timer without creating an account. If someone is already signed in to Tomatoro, their sessions sync automatically — but it's never required.

Make it part of your daily template

The best place for the widget is whichever page you open first. Drop it at the top of your daily notes template, your sprint planning board, or your study tracker. When the timer is already there before you start, you skip the step where you forget to use it.