MCP Shrimp Task Manager

Intelligent task management for AI agents: plan, decompose, and execute dev tasks with persistent memory.

Unverified

stdio (local)

No auth

Stale

JavaScript

View repo 2.1k Website

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git && cd mcp-shrimp-task-manager && npm install && npm run build

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-shrimp-task-manager": {
      "command": "node",
      "args": [
        "/path/to/mcp-shrimp-task-manager/dist/index.js"
      ],
      "env": {
        "DATA_DIR": "/path/to/your/shrimp_data",
        "TEMPLATES_USE": "en",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js 18+
npm or yarn
MCP-compatible AI client (e.g. Claude Code, Claude Desktop, Cline, Cursor, Windsurf)
Clone and build the repository (npm install && npm run build)

About MCP Shrimp Task Manager

An MCP server that transforms how AI agents approach software development by providing persistent task memory, structured planning/execution/verification workflows, automatic task decomposition, and dependency tracking. It converts natural-language requests into structured, testable dev tasks and supports a research mode and project-wide coding standards.

Tools & capabilities (16)

plan_task

Create a comprehensive task plan from a natural-language description.

execute_task

Execute a specific task by id.

list_tasks

Display all tasks with their status.

delete_task

Remove a task from the queue.

complete_task

Mark a task as completed.

update_task

Modify task details and requirements.

split_tasks

Break down a complex task into subtasks.

analyze_task

Perform deep analysis of task requirements and complexity.

verify_task

Validate that a task has been completed correctly.

reflect_task

Review and improve the approach taken for a task.

query_task

Search tasks by criteria such as status.

get_task_detail

Retrieve detailed information and history for a task.

clear_all_tasks

Remove all tasks, creating an automatic backup.

init_project_rules

Initialize project standards and coding rules.

research_mode

Enter systematic research mode to explore technologies and solutions.

process_thought

Process and structure thoughts (used internally by the agent).

What this server can do

MCP Shrimp Task Manager provides tools for these capabilities — tap one to see every MCP server that does the same:

Manage tasks & projects

When to use it

Feature development: plan a feature (e.g. JWT authentication), auto-decompose into subtasks, and execute step by step.
Bug fixing: research an issue, create a fix plan, and run all fix tasks in continuous mode.
Research and learning: compare technologies (e.g. React vs Vue) and create a migration plan from the findings.
Maintaining context across long sessions and token limits via persistent task memory.
Enforcing consistent coding standards across a project with project rules.

Security notes

Runs locally over stdio with no authentication. Task data is stored on disk at the path set by DATA_DIR. The README's example launches Claude Code with `--dangerously-skip-permissions`; use that flag with caution. An optional web GUI (ENABLE_GUI=true) and a separate Task Viewer expose local HTTP interfaces.

MCP Shrimp Task Manager FAQ

Is there an npm package to run it directly?

No. The README installs it by cloning the repo, running npm install, and npm run build, then pointing the MCP client at dist/index.js.

Which AI clients are supported?

Any MCP-compatible client. The docs show configuration for Claude Code (.mcp.json), Claude Desktop, and Cline, and the project targets Cursor and Windsurf as well.

Do tasks persist across sessions?

Yes. Task data is stored on disk under the DATA_DIR path, so tasks and progress persist across sessions and survive token limits.

Is there a visual interface?

Yes. There is a React-based Task Viewer (run from tools/task-viewer) and an optional lightweight Web GUI enabled with ENABLE_GUI=true.

#task-manager #agent #task-list #chain-of-thought #coding-assistant #workflow #cursor #windsurf

Alternatives to MCP Shrimp Task Manager

Compare all alternatives →

mcp-atlassian (community Jira/Confluence)

Productivity

5.4k

Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.

Verified

stdio (local)

API key

Python

11 tools

Updated 2 months agoRepo

Excel MCP Server

Productivity

3.9k

Create, read, and modify Excel workbooks with your AI agent — no Microsoft Excel required.

Unverified

stdio (local)

No auth

Python

25 tools

Updated 2 months agoRepo

Notion MCP Server (official)

Productivity

3.9k

Official Notion server to read, search, create, and update pages and databases in your workspace.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 4 months agoRepo

Compare MCP Shrimp Task Manager with:

vs mcp-atlassian (community Jira/Confluence)vs Excel MCP Server vs Notion MCP Server (official)vs mcp-obsidian (Obsidian Local REST API)