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.
Overview
Task Planner MCP Server is an MCP (Model Context Protocol) server designed to assist AI assistants like Claude in breaking down complex tasks into manageable steps, tracking progress, and managing a hierarchical task list.
To use the Task Planner MCP Server, clone the repository, install the dependencies, and run the server. Configure it with Claude Desktop by adding the server details to the claude_desktop_config.json file.
- 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)
- Managing personal projects by breaking them into smaller tasks
- Assisting AI assistants in organizing and tracking tasks
- Facilitating collaborative task management in teams
Add to your AI client
Use these steps to connect Task Planner MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"planner-captaincrouton89": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-planner-captaincrouton89"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"planner-captaincrouton89": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-planner-captaincrouton89"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"planner-captaincrouton89": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-planner-captaincrouton89"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"planner-captaincrouton89": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-planner-captaincrouton89"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"planner-captaincrouton89": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-planner-captaincrouton89"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"planner-captaincrouton89": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-planner-captaincrouton89"
]
}
}
}FAQ
Can I use Task Planner MCP Server with any AI assistant?
Yes! It is designed to work with AI assistants that support the Model Context Protocol.
Is there a limit to the number of tasks I can create?
No, you can create as many tasks and subtasks as needed.
How is task data stored?
Task data is stored in a local JSON file (`tasks.json`) in the root directory of the project.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3538,"uuid":"df67b9c2-9d49-4b04-81df-bd33d91207a2","name":"planner","title":"Task Planner MCP Server","description":"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.","avatar_url":"https://avatars.githubusercontent.com/u/49383285?v=4","created_at":"2025-03-20T04:35:58.607Z","updated_at":"2025-03-20T05:03:42.233Z","status":"created","author_name":"CaptainCrouton89","author_avatar_url":"https://avatars.githubusercontent.com/u/49383285?v=4","tags":"mcp-server","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/CaptainCrouton89/planner","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-22 18:24:24\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]