openpomodoro-mcp

MCP server for OpenPomodoro, built with Bonzai.

Install

go install github.com/open-pomodoro/openpomodoro-mcp/cmd/pomodoro-mcp@latest

Dependencies

• BuddhiLW/bonzai v0.57.1-mcp - Bonzai with native MCP support
• BuddhiLW/go-openpomodoro v0.1.0-break - Fork with break support (upstream PR pending)

Claude Code Setup

claude mcp add pomodoro -- /path/to/pomodoro-mcp

Tools

Tool	Description	Params
start	Start a pomodoro	description, duration, tags
status	Get current status	-
finish	Mark complete	-
cancel	Cancel active	-
clear	Clear finished	-
break	Start break	duration
repeat	Repeat last	-
amend	Modify active	description, duration, tags
history	List past	limit
settings	Show config	-

Example

> start a 25 min pomodoro for "writing docs"
Pomodoro started: writing docs (25:00)

> status
Active: writing docs
Remaining: 23:45
Goal: 2/8

License

MIT