# 🍅 TodoPomo MCP Server

> AI-powered task management with Pomodoro technique for Claude Desktop

[![npm version](https://img.shields.io/npm/v/todopomo-mcp.svg)](https://www.npmjs.com/package/todopomo-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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!