Shrimp Task Manager MCP Server

Content

Shrimp Task Manager is an MCP server for structuring AI-assisted development work into persistent tasks. It exposes tools for planning work, analyzing requirements, splitting complex tasks, listing and querying task state, executing a selected task, verifying completion, reflecting on approach, recording research, and initializing project rules.

The project is implemented as a Node.js MCP server. It stores task state in a configured data directory and can optionally start a web GUI for task viewing.

Source Review

• https://github.com/cjo4m06/mcp-shrimp-task-manager
• https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/README.md
• https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/package.json
• https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/tools.md
• https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/agents.md
• https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/src/index.ts
• https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/LICENSE
• https://registry.npmjs.org/mcp-shrimp-task-manager
• https://cjo4m06.github.io/mcp-shrimp-task-manager/

These sources were reviewed on 2026-06-05. Prefer the live repository, README, package metadata, tools documentation, agent documentation, server source, license, NPM registry metadata, and generated docs site for current installation commands, environment variables, supported tools, and GUI behavior.

Features

• Plan development tasks from natural-language descriptions.
• Analyze task requirements before implementation.
• Split complex tasks into smaller subtasks with dependencies.
• List, query, update, delete, and inspect task records.
• Execute and verify tasks through a structured workflow.
• Reflect on a task approach before continuing.
• Store persistent task history in a configured data directory.
• Initialize project rules and enter research mode.
• Assign specialized agent profiles to tasks.
• Optionally run a web task viewer or GUI for visual status review.

Installation

Install dependencies, build the server, and configure a writable data directory following the upstream README:

npm install
npm run build

Then connect the built server to Claude or another MCP client:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["PATH_TO_SHRIMP_TASK_MANAGER/dist/index.js"],
      "env": {
        "DATA_DIR": "WRITABLE_SHRIMP_DATA_DIR",
        "TEMPLATES_USE": "en",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Start with project rules and a small planning task before using continuous execution patterns.

Use Cases

• Break a large development request into dependency-aware implementation tasks.
• Keep task state available across model-context resets or new sessions.
• Ask Claude to research a technical decision before turning it into a plan.
• Track which subtasks are pending, in progress, complete, or blocked.
• Review a generated implementation approach before executing the next task.
• Assign specialized task personas for frontend, backend, QA, documentation, or security work.

Safety and Privacy

Shrimp Task Manager is most useful when it persists project context, but that means its data directory can become a durable project record. Treat generated tasks, project rules, agent assignments, research notes, and backups as project data that may need review before sharing or committing.

Do not let task status replace human verification. A model can mark tasks complete, update task text, or clear task state through tools, but code, documentation, tests, and product decisions still need normal review. If the GUI is enabled, keep its server on trusted interfaces only.

Duplicate Check

Existing planning entries cover spec and approval workflows, but no cjo4m06/mcp-shrimp-task-manager, Shrimp Task Manager, or matching source URL was found in content/mcp.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationcjo4m06.github.io
• Submitted by oktofeesh12026-06-05