TodoPomo

TodoPomo is an MCP server that lets Claude or any MCP-compatible AI manage your tasks and Pomodoro sessions. You can interact naturally to add tasks, track progress, run focus sessions, and view productivity stats—with all data stored locally.

How to use

You connect an MCP client to TodoPomo and then issue natural language requests to manage tasks and Pomodoro sessions. Practical actions include adding tasks with priorities, listing or filtering tasks, starting Pomodoro sessions, updating settings for timer lengths, and reviewing your productivity stats. The server exposes 9 tools you can invoke through your MCP client to perform these actions.

How to install

Prerequisites: you need Node.js installed on your system. You also need a MCP client application to communicate with TodoPomo.

Install TodoPomo MCP globally using npm.

npm install -g todopomo-mcp

Configure the MCP server in your Claude Desktop setup to use the local TodoPomo MCP server.

{
  "mcpServers": {
    "todopomo": {
      "command": "npx",
      "args": ["-y", "todopomo-mcp"]
    }
  }
}

Restart Claude Desktop to apply the changes. TodoPomo is ready to use once Claude reconnects to the MCP server.

Configuration and tools

TodoPomo is built with TypeScript and stores data locally in JSON files. It exposes a set of tools to manage tasks and Pomodoro sessions, and provides default timer settings that you can customize through your MCP client.

Default timer settings (adjustable through the client):

• Work: 25 minutes
• Short break: 5 minutes
• Long break: 15 minutes
• Pomodoros before long break: 4

Available tools

TodoPomo provides the following tools you can call via the MCP client to manage tasks and Pomodoro sessions.

• add_task: Create new tasks with optional priority and estimates
• list_tasks: View tasks and filter by status or priority
• update_task: Modify existing tasks
• delete_task: Remove tasks
• start_pomodoro: Begin a work or break session
• complete_pomodoro: End the current session
• get_pomodoro_stats: Retrieve productivity statistics
• update_settings: Change timer durations and Pomodoro behavior
• get_active_session: Check what session is currently running

Available tools

add_task

Create a new task with optional priority and estimated Pomodoros.

list_tasks

View your tasks and filter by status (pending, completed) or priority.

update_task

Modify a task's details, such as title, priority, or status.

delete_task

Remove a task from your list.

start_pomodoro

Start a work or break session with configurable duration.

complete_pomodoro

Finish the current Pomodoro session and record completion.

get_pomodoro_stats

Retrieve productivity data and summaries for a given period.

update_settings

Customize timers and Pomodoro behavior (durations, long break frequency, etc.).

get_active_session

Check which Pomodoro session is currently active, if any.