pomoduck
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
pomoduck
A small Pomodoro timer for the terminal, plus an MCP server so AI agents (Claude, Cursor, Cline…) can start, check and log focus sessions. Zero dependencies, Node 18+.
Same timers run in the browser at PomoDuck — free Pomodoro timer, where focus sessions also grow a little duck farm.
npx pomoduck # 25 min focus, then a 5 min break
npx pomoduck 50 # 50 min focus, 10 min break
npx pomoduck run deep # loop 50/10 rounds until Ctrl+C
npx pomoduck plan 120 # split 2 hours into rounds and breaks
npx pomoduck stats # focus minutes for the last 7 daysSessions are stored locally in ~/.pomoduck/state.json (override with POMODUCK_HOME). Nothing is sent anywhere.
Techniques
id | Focus / break | Long break | Good for | Browser timer |
| 25 / 5 | 15 after 4 | Most desk work, starting a task you avoid | |
| 10 / 2 | 10 after 4 | Low energy, ADHD-friendly starts, chores | |
| 50 / 10 | 30 after 3 | Writing, coding, dense study | |
| 52 / 17 | — | Knowledge work with offline breaks | |
| 90 / 20 | — | One or two big creative blocks a day | |
| 45 / 15 | 30 after 3 | Exam revision, reading, problem sets |
The table lives in data/techniques.json if you want to reuse it.
New to the method? Read what the Pomodoro technique is.
Related MCP server: Task MCP Server
CLI
pomoduck [minutes] focus timer (default 25), then a break
pomoduck run <technique> loop focus/break rounds
pomoduck break [minutes] break timer (default 5)
pomoduck plan <minutes> [technique]
pomoduck status
pomoduck stats [days]
pomoduck techniques
pomoduck mcp run as an MCP server on stdio
-l, --label <text> what the session is for
--no-break skip the break after focusCtrl+C stops a session and logs it as abandoned. The terminal bell rings when a timer ends.
MCP server
{
"mcpServers": {
"pomoduck": { "command": "npx", "args": ["-y", "pomoduck", "mcp"] }
}
}Claude Code: claude mcp add pomoduck -- npx -y pomoduck mcp
Tool | What it does |
| Start a focus or break timer ( |
| Running session and seconds left |
| Stop early (logged as abandoned) |
| Focus minutes and sessions over the last N days |
| Split focus time into rounds of a technique |
| The technique table above |
Example prompts: "Start a 50 minute focus session for the API refactor", "How much did I focus this week?", "Plan 3 hours of study with 45/15 blocks."
The timer state is a file, so the CLI and the MCP server see the same session: start it from your agent, check it with pomoduck status in a terminal.
Want more than a terminal timer?
PomoDuck is the free web version: a focus timer with tasks, daily goals, streaks and a heatmap, a website blocker extension for Chrome, and an Android app. Focus earns seed, breaks earn water, and your ducks turn both into eggs.
License
Code: MIT. Technique data (data/techniques.json): CC BY 4.0 — suggested credit: Focus techniques by PomoDuck.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Pomodoro work sessions from your AI chat: timed focus blocks, session logs.
Plan work sessions and run pomodoro timers right in the conversation.
ADHD system of record for agents: tasks, goals, loops, calendar, focus stats.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Related MCP Servers
- AlicenseAqualityDmaintenanceIntegrates task management with the Pomodoro Technique, enabling AI assistants to manage productivity workflows through timed work sessions, task tracking, and comprehensive productivity statistics.92MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI clients to manage todo tasks through Tools for adding, listing, completing, and searching, alongside Prompts for daily reviews and task breakdowns. Exposes task lists and statistics as Resources with local JSON file persistence.-
- AlicenseNot gradedqualityDmaintenanceEnables coding agents to create, start, pause, and delete labeled timers within projects, with persistence via SQLite, through a stdio MCP interface.MIT
- AlicenseBqualityCmaintenanceEnables AI agents to start and log pomodoro and deep work sessions, manage tasks, and query a permanent per-skill ledger of focus hours via MCP.14MIT