Planner

🚀 Task Planner MCP Server

A Model Context Protocol (MCP) server that helps AI assistants (e.g., Claude) break down complex tasks into actionable steps, track progress, and manage hierarchical task lists.

🚀 Quick Start

The Task Planner MCP Server is a powerful tool for managing tasks. It allows you to handle tasks efficiently and integrate with AI assistants like Claude.

✨ Features

• Create, update, and delete tasks.
• Break down complex tasks into multiple subtasks.
• Mark tasks as completed.
• View detailed task information.
• List all tasks or all 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 Examples

Basic Usage

Run the Server

pnpm start

Configure Claude Desktop

To use this MCP server in 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.

Advanced Usage

The Task Planner MCP Server provides the following tools:

create-task

Create a new task or subtask. Parameters:

• title: The title of the task.
• description (optional): A detailed description of the task.
• parentId (optional): The ID of the parent task if this is a subtask.
• priority (optional): The priority of the task (low, medium, high).

list-tasks

List all tasks or subtasks. Parameters:

• parentId (optional): List all subtasks of a specific parent task.

get-task

Get detailed information about a task. Parameters:

• id: The ID of the task to retrieve.

complete-task

Mark a task as completed. Parameters:

• id: The ID of the task to complete.

update-task

Update the detailed information of a task. Parameters:

• id: The ID of the task to update.
• title (optional): The new title of the task.
• description (optional): The new description of the task.
• priority (optional): The new priority of the task (low, medium, high).

delete-task

Delete a task and its subtasks. Parameters:

• id: The ID of the task to delete.

break-down-task

Break down a complex task into multiple subtasks. Parameters:

• parentId: The ID of the parent task to break down.
• subtasks: An array of subtasks, each containing:
  • title: The title of the subtask.
  • description (optional): The description of the subtask.
  • priority (optional): The priority of the subtask (low, medium, high).

Example Usage

Here are some examples of using the task planner with Claude:

1. "Create a new task named 'Plan my vacation'."
2. "Break down my vacation planning task into smaller steps."
3. "What are my pending tasks?"
4. "Show detailed information about my vacation planning task."
5. "Mark the flight booking subtask as completed."
6. "Delete the task about grocery shopping."

📚 Documentation

Data Storage

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

📄 License

ISC