# todopomo-mcp
## 基本信息
- Slug: `pratyayrajak-todopomo-mcp`
- Source: modelscope
- Publisher: @PratyayRajak/todopomo-mcp
- Categories: app-automation / workplace-and-productivity / note-taking
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@PratyayRajak/todopomo-mcp
## 简介
暂无描述。
## 安装提示

```bash
npm install -g todopomo-mcp
```

## MCP Server 详情

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