Shrimp Task Manager MCP Server: Task Planning for Coding Agents

• Starts planning a feature or project

  Returns step-by-step planning instructions for the assistant to follow, and can look at tasks you already have. It does not save anything itself.

  Try: “Plan a user-login feature for this project.”

  Read · plan_task

• Checks a plan against your codebase

  Gives the assistant instructions to look through the code, judge feasibility and risks, and write the result as high-level steps.

  Try: “Analyze whether this plan fits our current code.”

  Read · analyze_task

• Reviews an analysis for gaps

  Gives the assistant instructions to check the analysis for completeness and better options before it commits to tasks.

  Try: “Reflect on the plan and tell me what is missing.”

  Read · reflect_task

• Breaks a plan into saved tasks

  Turns a plan into a task list with priorities and dependencies and saves it. By default it clears all existing tasks first and keeps a backup, unless the update mode is append, overwrite or selective.

  Try: “Split the login plan into tasks and keep my current ones.”

  Delete · split_tasks

• Shows all tasks and their status

  Returns the saved task list with status, priority and dependencies.

  Try: “List my tasks.”

  Files · list_tasks

• Searches tasks by keyword or ID

  Finds tasks that match a keyword or ID and shows short summaries.

  Try: “Find the tasks about authentication.”

  Files · query_task

• Shows everything about one task

  Returns a task in full, including its implementation guide and verification criteria.

  Try: “Show full details of the login form task.”

  Files · get_task_detail

• Gets the instructions for doing one task

  Marks the task as in progress and returns guidance the assistant must follow to complete it. Calling it does not finish the task.

  Try: “Start the login form task.”

  Write · execute_task

• Scores a finished task

  Scores the work against the task criteria. A score of 80 or more marks the task completed and saves a summary.

  Try: “Verify the login form task.”

  Write · verify_task

• Edits a task

  Changes a task name, description, notes, dependencies, related files, guide or criteria. Completed tasks only allow summary and related files to change.

  Try: “Add a note to the login task that it needs the new API.”

  Write · update_task

• Deletes an unfinished task

  Removes one task that is not completed. Completed tasks cannot be deleted.

  Try: “Delete the duplicate profile task.”

  Delete · delete_task

• Wipes the unfinished task list

  Clears all unfinished tasks and resets the list, after you confirm. Completed tasks are backed up first.

  Try: “Clear all tasks and start over.”

  Delete · clear_all_tasks

• Thinks a problem through step by step

  Lets the assistant build, question and correct ideas over several steps, and prefers reading project code over guessing.

  Try: “Think through how to cache these API calls.”

  Read · process_thought

• Creates the project rules document

  Initializes or updates a standards document for the project, so later tasks follow the same conventions.

  Try: “Initialize project rules for this repo.”

  Read · init_project_rules

• Researches a technical topic in a structured way

  Puts the assistant in a research mode that guides it to use web and code search systematically on a topic.

  Try: “Research the best way to handle file uploads.”

  Read · research_mode

Watch out for

• It can delete tasks and wipe the list

  delete_task removes one unfinished task, and clear_all_tasks resets the list after confirmation. Completed tasks are backed up before a wipe. github.com

• A new plan clears unfinished tasks by default

  split_tasks defaults to a mode that clears all tasks and backs them up. Ask the assistant to use append or selective when you want to keep your list. github.com

• The optional web viewer listens on every network interface

  With ENABLE_GUI=true the viewer starts on a random free port with no password and no host set, so it listens on every network interface. It only serves your task list (read-only), but anyone on the network can read it. Leave it off, or use it only on a trusted network. github.com

• The planning tools return instructions, not results

  Tools like plan_task and execute_task send guidance that the assistant must follow. They do not run code on their own. github.com

Security advisories