MCP TaskManager

MCP TaskManager

Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.

Prerequisites

• Node.js 18+ (install via brew install node)
• Claude Desktop (install from https://claude.ai/desktop)
• tsx (install via npm install -g tsx)

Installation

1. Clone the Repository:

   git clone https://github.com/pashpashpash/mcp-taskmanager.git
   cd mcp-taskmanager
   

2. Install Dependencies:

   npm install
   

3. Build the Project:

   npm run build
   

4. Configure Claude Desktop:

Locate your Claude Desktop configuration file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

You can also find this through the Claude Desktop menu:

1. Open Claude Desktop
2. Click Claude on the Mac menu bar
3. Click "Settings"
4. Click "Developer"

Add the following to your configuration:

{
  "tools": {
    "taskmanager": {
      "command": "node",
      "args": ["path/to/mcp-taskmanager/dist/index.js"]
    }
  }
}

Note: Replace "path/to/mcp-taskmanager" with the actual path to your cloned repository.

Development Setup

1. Install tsx globally (if not already installed):

   npm install -g tsx
   

2. Development Configuration:

   For development with the TypeScript source, modify your Claude Desktop config:

   {
     "tools": {
       "taskmanager": {
         "command": "tsx",
         "args": ["path/to/mcp-taskmanager/index.ts"]
       }
     }
   }
   

Available Operations

The TaskManager supports two main phases of operation:

Planning Phase

• Accepts a task list (array of strings) from the user
• Stores tasks internally as a queue
• Returns an execution plan (task overview, task ID, current queue status)

Execution Phase

• Returns the next task from the queue when requested
• Provides feedback mechanism for task completion
• Removes completed tasks from the queue
• Prepares the next task for execution

Parameters

• action: "plan" | "execute" | "complete"
• tasks: Array of task strings (required for "plan" action)
• taskId: Task identifier (required for "complete" action)
• getNext: Boolean flag to request next task (for "execute" action)

Example Usage

// Planning phase
{
  action: "plan",
  tasks: ["Task 1", "Task 2", "Task 3"]
}

// Execution phase
{
  action: "execute",
  getNext: true
}

// Complete task
{
  action: "complete",
  taskId: "task-123"
}

Debugging

If you run into issues, check Claude Desktop's MCP logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Development

# Install dependencies
npm install

# Build the project
npm run build

# Development with auto-rebuild
npm run watch

License

MIT

Note: This is a fork of the original mcp-taskmanager repository.