Pomoduck

● Active

io.github.comficker/pomoduck

Pomodoro timer for AI agents: start, check and log focus sessions, plan rounds.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "pomoduck": {
      "command": "npx",
      "args": [
        "-y",
        "pomoduck@0.1.0",
        "mcp"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add pomoduck -- npx -y pomoduck@0.1.0 mcp
OpenAI Codex CLI
codex mcp add pomoduck -- npx -y pomoduck@0.1.0 mcp
VS Code
code --add-mcp '{"name":"pomoduck","type":"stdio","command":"npx","args":["-y","pomoduck@0.1.0","mcp"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Productivity
Version
0.1.0
Registry
active
Published
11/19/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Pomoduck is maintained, open source.

Maintained
Active
Last commit 3 days ago (Nov 19, 2026), 0 open issues.
Official registry
Active
Published as io.github.comficker/pomoduck in the official MCP registry, version 0.1.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
None declared
The registry entry declares no required environment variables.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 19, 2026
License
MIT

JavaScript

From the README

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. Sessions are stored locally in ~/.pomoduck/state.json (override with POMODUCK_HOME). Nothing is sent anywhere. Techniques The table lives in data/techniques.json if you want to reuse it. New to the method? Read what the Pomodoro technique is. CLI Ctrl+C stops a session and logs it as abandoned. The terminal bell rings when a timer ends. MCP server Claude Code: claude mcp add pomoduck -- npx -y pomoduck mcp 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.

Read the full README on GitHub →

The most-starred Productivity servers in the index, with their live-check result.

ServerStarsLast pushLive check
Front-End Checklist74,746Oct 2026Working
Windmill18,600Nov 2026Needs sign-in
Agent-Native Content7,735Nov 2026Needs sign-in
Agent-Native Calendar7,735Nov 2026Needs sign-in
Agent-Native Plan7,735Nov 2026Needs sign-in

Pomoduck: questions people ask

Is Pomoduck a remote or a local MCP server?
According to its entry in the official MCP registry, Pomoduck ships as a local package (npm) that your client starts on your machine.
Is Pomoduck safe to use?
Looks healthy: Pomoduck is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: None declared. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Pomoduck still maintained?
Active: the repository's last commit 3 days ago. Last push Nov 19, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 21, 2026.
How do I add Pomoduck to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. Checklist Templates410 checklist templates (moving, cleaning, packing, wedding, inspections) with printable PDF links.★ 1
  2. Factcovery Facts500+ short, sourced fun facts: random fact, fact of the day, search and facts by topic.★ 1
  3. Pixel Art MCPTurn images into pixel art, extract and remap palettes, and upscale sprites without blur.★ 1
Browse all Productivity →

Add the badge to your site

Show visitors that Pomoduck is listed here — it’s also the link we check for a free listing.

Pomoduck — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-comficker-pomoduck?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Pomoduck — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Pomoduck — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-comficker-pomoduck?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-comficker-pomoduck) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-comficker-pomoduck) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-comficker-pomoduck)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-comficker-pomoduck"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-comficker-pomoduck"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-comficker-pomoduck"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).