Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open