MCP Tasks Organizer

An MCP server that converts Cursor agent plans into structured markdown task lists and organizes them in your repository. This server helps you track AI-generated plans and recommendations as actionable specifications.

Features

• Automatically extracts tasks from Cursor agent plans
• Creates a .tasks folder in your repository for organized task management
• Uses descriptive filenames (e.g., “refactor-authentication.md”) for easy identification
• Automatically marks completed task lists with a ✅ prefix
• Formats plans with proper Markdown structure
• Organizes content into Overview, Implementation Details, and Next Steps
• Integrates with Claude for Desktop and other MCP clients

Installation

Prerequisites

• Python 3.10 or higher
• pip or another Python package manager

Quick Install

For Unix-based systems (macOS, Linux):

# Clone the repository
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# Run the installation script
./install.sh

For Windows:

# Clone the repository
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# Run the installation script
install.bat

Manual Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# Create and activate a virtual environment (optional but recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install the package
pip install -e .

Usage with Claude for Desktop

1. Install Claude for Desktop from claude.ai/download

2. Configure Claude for Desktop to use this MCP server:

   Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

   {
     "mcpServers": {
       "tasks-organizer": {
         "command": "python",
         "args": ["-m", "tasks_organizer"]
       }
     }
   }
   

3. Restart Claude for Desktop

4. Use the server by asking Claude about your cursor plans, for example:

   • “Convert this cursor plan into a task list called ‘Refactor Authentication’ with description ‘auth-refactor’: [paste plan]”
   • “Create a markdown task list from this cursor agent output with title ‘Database Migration’ and description ‘db-migration’: [paste output]”
   • “Mark task 2 in the auth-refactor task list as complete”
   • “List all task files in my repository”

Available Tools

The server provides these tools:

1. create_task_list

Create a new task list and save it to the .tasks folder.

Parameters:

• title: Title for the task list
• description: Short 2-3 word description for the filename (e.g., “refactor-authentication”)
• repo_path: Path to the repository root (defaults to current directory)