How can we help?

Search the answers, or write to us. We read every message.

Getting started

How do I install PomoDeck and the plugin?

The Microsoft Store build is the recommended one. It is signed and updates itself.

  1. Install PomoDeck from the Microsoft Store.
  2. Launch it once from the Start menu. This registers the app so the plugin can find it.
  3. Download PomoDeck.lplug4 and double-click it. Logi Options+ installs the plugin.
  4. In Logi Options+, drag PomoDeck actions onto your console keys or into the Actions Ring. Start with Focus Timer and Adjust Time.
Can I install it without the Microsoft Store?

Yes. Get the installer from the latest release, then install the plugin the same way: double-click PomoDeck.lplug4 and add the actions in Logi Options+.

The standalone build does not update itself, so check back occasionally.

Does PomoDeck work without a Logitech device?

Yes. PomoDeck is a full standalone desktop Pomodoro timer. The Logitech plugin is optional and adds physical buttons, LCD widgets, and haptic feedback.

Do I need the app if I only want the plugin?

No. The plugin runs the timer on its own. The app adds flow scoring, distraction blocking, statistics, tasks on the console, and the Pomo Jar. Install both for the full experience.

Which Windows versions are supported?

Windows 10 and Windows 11, 64-bit. A macOS build is in progress.

Troubleshooting

The app freezes, stops responding, or closes on its own

Tell us which build you use (Microsoft Store or standalone) and roughly what you were doing when it happened.

Then open SettingsAboutOpen Log Folder and send us the newest log file. That log is usually the difference between a guess and a fix.

Windows warns about an unknown publisher

Only the standalone installer triggers this. Choose More info, then Run anyway.

The Microsoft Store build is signed and never shows the warning.

The plugin cannot find or launch the app

Launch PomoDeck once from the Start menu so Windows registers it.

After that the plugin connects over localhost port 1314 while the app sits in your system tray.

The plugin does not appear in Logi Options+

Restart Logi Options+, then double-click the .lplug4 file again.

If it still does not show, confirm Logi Options+ is up to date and that your device is a supported MX Creative Console or Actions Ring device.

The app and the console are out of sync

Check the app is actually running — look for it in the system tray, not the taskbar.

If it is running, open SettingsSystem and confirm the WebSocket server is switched on and set to port 1314.

Website blocking does not block anything

Set your browser to use the system proxy settings. Chrome and Edge do this by default; Firefox needs it selected manually under Network Settings.

Blocking only runs during focus rounds, never on breaks. PomoDeck clears the proxy setting when it exits.

If a site still loads, add it exactly as the domain — youtube.com, not https://www.youtube.com/feed.

I get no haptic feedback

Haptics come from the mouse, not the console, and need a device that supports them such as the MX Master 4.

Check that the device is connected in Logi Options+ and that haptics are enabled there.

My Pro key will not activate

Enter the key under SettingsSubscription, exactly as it appears in the email, with no trailing space.

Activation needs an internet connection the first time. If it still fails, email us the key and we will look it up.

Plans and billing

I bought from the Microsoft Store — how do I get Pro?

Pro is sold through our own checkout, not the Microsoft Store. After purchase you receive a license key by email. Enter it in the app under Settings, then Subscription. The Store and standalone builds both accept the same key.

What is free, and what does Pro add?

Free covers the whole daily habit: the timer, flow scoring and session grades, unlimited tasks, unlimited website and app blocking, your Pomo Jar and streak, and the last 7 days of history. Pro adds memory and power — your complete history, any date on the calendar, the yearly heatmap, the Eisenhower Matrix and priority sort, custom sounds, all themes and languages, and letting an AI assistant change your plan. Pro is $12 a year, which works out at $1 a month, or $96 once for a lifetime licence. There is also a $2.99 monthly plan if you would rather not commit.

Is there a trial?

Every install starts with 7 days of full Pro access. No card, no account, nothing to cancel. When it ends nothing you recorded is deleted. The history views narrow to the last 7 days until you buy Pro.

How do I get my money back?

Email us within 14 days of purchase and we will refund it. No form to fill in.

I lost my licence key

Email us from the address you paid with and we will resend it.

How do I cancel?

Cancel any time. You keep Pro until the end of the period you already paid for.

How it works

What is flow scoring?

A live 0 to 100 score for the quality of the current session. It climbs while you stay in focus and drops when you pause, go idle, or get pulled away. Six named levels run from Sleeping up to Deep Flow at 85 and above.

How does website blocking work?

PomoDeck runs a local proxy configuration on your own machine and points your browser at it during focus rounds. Blocked sites show a focus page instead of loading. No admin rights are needed and everything unblocks when your break starts.

Does my data leave my computer?

Sessions, tasks, and statistics are stored locally in a database on your machine. Nothing is uploaded. License checks and update checks are the only network calls the app makes.

AI assistants

Is PomoDeck an AI Pomodoro planner?

Yes, among other things. It is a full Pomodoro focus timer, and it ships a local Model Context Protocol server so an AI assistant can act as your day planner: reading what is already scheduled, checking a proposed day against what you normally finish on that weekday, and writing tasks in with estimates and subtasks. The planning happens in your assistant; the timing and the record happen in PomoDeck. The AI side is optional and the timer works with no assistant and no network.

Can an AI plan my day and track whether I did it?

That is the intended workflow. Your assistant shapes the day and writes it onto your timer, then PomoDeck records what actually ran, how long each session lasted and how focused it was, all on your own machine. Because an assistant cannot start, pause or skip the timer, the history is evidence rather than a claim, and the next plan can be made against it instead of against optimism.

Can I connect PomoDeck to Claude or another AI assistant?

Yes. PomoDeck includes a Model Context Protocol server, so any MCP client — Claude Desktop, Claude Code, Cursor or VS Code — can read your tasks, schedule and focus pattern and put work on your timer. Open Settings, then Integrations, and pair a client to get a token. The server runs on 127.0.0.1 on your own machine and is not reachable from the internet. PomoDeck has to be running for the connection to work.

What can an AI assistant actually do to my PomoDeck?

It can read your tasks, schedule, focus pattern and day capacity, and it can create, edit, schedule, complete and delete tasks. It cannot start, pause or skip your timer — that is deliberate, so no session in your history can be fabricated. Anything that reshapes more than a day arrives as a proposal with a diff you approve or decline, and you can undo an approved plan afterwards. Pairing and reading are free on every plan; letting an assistant make changes needs Pro.

Does connecting an assistant send my data anywhere?

PomoDeck itself sends nothing. The connection is a local server on 127.0.0.1 that only accepts requests from your own machine, and access needs a token you generate and can revoke. What your assistant does with what it reads is governed by that assistant’s own privacy policy — if it runs in the cloud, the task titles it reads go to its servers, the same as anything else you type into it.

Uninstall

How do I uninstall the app?

Right-click PomoDeck in the Start menu and choose Uninstall, or go to SettingsAppsInstalled appsPomoDeck.

Your sessions and settings live in your user AppData folder and are removed with the app. Nothing is stored on our servers.

How do I remove the plugin?

In Logi Options+, open Plugins and remove PomoDeck.

Still stuck? Write to us

We read every message. Use the form, or email hello@pomodeck.com.

Check first: most-wanted requests (a 👍 counts for more than a duplicate) and known issues.

The gap between the two is usually the bug.

Even a rough list helps. Reproducible bugs get fixed first.

SettingsAbout. Your browser details are attached automatically.

Screenshots or logs? Reply to our email with them. Logs are under SettingsAboutOpen Log Folder.