PomoDash — Claude Code MCP server: tasks and notes
Wires your AI client to PomoDash so tasks, notes and projects get created and edited from the chat.
no license updated 2026-10-29
Open on GitHubWhat PomoDash does
Your assistant gets a set of PomoDash tools to call: tasks can be created, listed, changed or removed, including one placed inside a chosen project; notes and categories follow the same pattern. Ask for something in plain language and the client picks the tool.
Run it from the published Docker image mcp/pomodash, or build the TypeScript yourself with Node.js 20+ and start node dist/index.js. The API key goes in POMODASH_API_KEY; POMODASH_API_URL points at the endpoint. The server entry then lives in your MCP client's JSON config, with Docker Desktop MCP Toolkit offering a catalog install as a shortcut.
A premium PomoDash account is required — on a free plan there is nowhere to issue the key. Grab it from the settings page when it appears, because the value (starting with pmk_) is shown once and never again.
What it helps with
- add a task to the right project without leaving the editor
- pull a category's task list into the conversation
- attach a note to a task after a call
- reword a task or move it to another status
- spin up a category for a new area of work
Example prompts for the agent
- List every task in the Work category and flag the overdue ones
- Create a task called “Triage the backlog” inside the Website project
- Write a note on the client call task and keep the summary there
How to install PomoDash
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PomoDash
How do I install PomoDash in Claude Code?
Add the server to your MCP client config: docker with the arguments run --rm -i -e POMODASH_API_KEY=pmk_your_api_key_here mcp/pomodash, then restart the client. Alternatively build it with npm run build and launch node against dist/index.js.
What does the PomoDash MCP server do?
It exposes tools for PomoDash tasks, notes, categories and projects, so the assistant can make those changes when you ask from the chat.
What do I need before it will run?
A premium PomoDash account and an API key from the settings page. Local runs need Node.js 20+; Docker works as the other route.