🍅 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!