TodoPomo MCP Server

AI-powered task management with Pomodoro technique for Claude Desktop

What is this?

TodoPomo is an MCP server that lets Claude (or any MCP-compatible AI) manage your tasks and Pomodoro sessions. Just talk naturally - no apps, no clicking.

Features:

• Task management with priorities
• Flexible Pomodoro timers
• Productivity statistics
• Local data storage
• Progress tracking

Installation

npm install -g todopomo-mcp

Add to Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json on Windows):

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

Restart Claude Desktop. Done!

Usage

Just ask Claude:

"Add a task to study JavaScript with high priority for 3 pomodoros"
"List all my pending tasks"
"Start a 25-minute work session"
"Show me my stats for today"
"Update settings to 50-minute work sessions"

Development

git clone https://github.com/YOUR_USERNAME/todopomo-mcp.git
cd todopomo-mcp
npm install
npm run build
npm start

How it Works

Built with TypeScript and the Model Context Protocol SDK. Provides 9 tools for task and time management:

• add_task - Create tasks
• list_tasks - View tasks (filter by status/priority)
• update_task - Modify tasks
• delete_task - Remove tasks
• start_pomodoro - Begin work/break sessions
• complete_pomodoro - Finish sessions
• get_pomodoro_stats - View productivity data
• update_settings - Customize timers
• get_active_session - Check current session

Data stored locally in JSON format.

Tech Stack

• TypeScript - Type-safe development
• Node.js - Runtime
• MCP SDK - Protocol implementation
• JSON - Data persistence

Default Settings

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

All customizable through Claude!

License

MIT - feel free to use and modify!

Author

Built with and by Pratyay Rajak

Questions? Open an issue or reach out!