Task Planner MCP Server

An MCP (Model Context Protocol) server that helps AI assistants (like Claude) break down complex tasks into manageable steps, track progress, and manage a hierarchical task list.

Features

• Create, update, and delete tasks
• Break down complex tasks into multiple subtasks
• Mark tasks as complete
• View detailed task information
• List all tasks or subtasks of a specific task
• Set task priorities (low, medium, high)

Installation

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

# Install dependencies
pnpm install

# Build the project
pnpm run build

Usage

Running the server

pnpm start

Claude Desktop Configuration

To use this MCP server with Claude Desktop, add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "task-planner": {
      "command": "node",
      "args": ["/absolute/path/to/task-planner-mcp/dist/index.js"]
    }
  }
}

Replace /absolute/path/to/task-planner-mcp with the absolute path to your task planner directory.

Available Tools

The Task Planner MCP Server provides the following tools:

create-task

Create a new task or subtask.

Parameters:

• title: Title of the task
• description (optional): Detailed description of the task
• parentId (optional): ID of the parent task if this is a subtask
• priority (optional): Priority level of the task (low, medium, high)

list-tasks

List all tasks or subtasks.

Parameters:

• parentId (optional): ID of the parent task to list subtasks for

get-task

Get detailed information about a task.

Parameters:

• id: ID of the task to retrieve

complete-task

Mark a task as completed.

Parameters:

• id: ID of the task to complete

update-task

Update a task's details.

Parameters:

• id: ID of the task to update
• title (optional): New title for the task
• description (optional): New description for the task
• priority (optional): New priority level for the task (low, medium, high)

delete-task

Delete a task and its subtasks.

Parameters:

• id: ID of the task to delete

break-down-task

Break down a complex task into multiple subtasks.

Parameters:

• parentId: ID of the parent task to break down
• subtasks: Array of subtask objects, each with:
  • title: Title of the subtask
  • description (optional): Description of the subtask
  • priority (optional): Priority of the subtask (low, medium, high)

Examples

Here are some examples of how to use the Task Planner with Claude:

1. "Create a new task called 'Plan my vacation'"
2. "Break down my vacation planning task into smaller steps"
3. "What tasks do I have pending?"
4. "Show me the details of my vacation planning task"
5. "Mark the flight booking subtask as complete"
6. "Delete the task about grocery shopping"

Data Storage

Task data is stored in a local JSON file (tasks.json) in the root directory of the project.

License

ISC