🍅 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 taskslist_tasks- View tasks (filter by status/priority)update_task- Modify tasksdelete_task- Remove tasksstart_pomodoro- Begin work/break sessionscomplete_pomodoro- Finish sessionsget_pomodoro_stats- View productivity dataupdate_settings- Customize timersget_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!
