TodoPomo MCP Server

# 🍅 TodoPomo MCP Server > AI-powered task management with Pomodoro technique for Claude Desktop [](https://www.npmjs.com/package/todopomo-mcp) [](https://opensource.org/licenses/MIT) ## 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 ```bash npm install -g todopomo-mcp ``` Add to Claude Desktop config (`%APPDATA%\Claude\claude_desktop_config.json` on Windows): ```json { "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 ```bash 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!