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