Task manager for coding agents that turns natural language into structured dev tasks with dependency tracking and reflection.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add shrimp-task-manager --env DATA_DIR='<DATA_DIR>' --env ENABLE_THOUGHT_CHAIN='<ENABLE_THOUGHT_CHAIN>' --env MCP_PROMPT_EXECUTE_TASK_APPEND='<MCP_PROMPT_EXECUTE_TASK_APPEND>' --env MCP_PROMPT_PLAN_TASK='<MCP_PROMPT_PLAN_TASK>' -- npx mcp-shrimp-task-manager~/.codex/config.toml
[mcp_servers.shrimp-task-manager]
command = "npx"
args = ["mcp-shrimp-task-manager"]
env = { DATA_DIR = "<DATA_DIR>", ENABLE_THOUGHT_CHAIN = "<ENABLE_THOUGHT_CHAIN>", MCP_PROMPT_EXECUTE_TASK_APPEND = "<MCP_PROMPT_EXECUTE_TASK_APPEND>", MCP_PROMPT_PLAN_TASK = "<MCP_PROMPT_PLAN_TASK>" }
# codex mcp add shrimp-task-manager --env DATA_DIR='<DATA_DIR>' --env ENABLE_THOUGHT_CHAIN='<ENABLE_THOUGHT_CHAIN>' --env MCP_PROMPT_EXECUTE_TASK_APPEND='<MCP_PROMPT_EXECUTE_TASK_APPEND>' --env MCP_PROMPT_PLAN_TASK='<MCP_PROMPT_PLAN_TASK>' -- npx mcp-shrimp-task-manager~/.cursor/mcp.json
{
"mcpServers": {
"shrimp-task-manager": {
"command": "npx",
"args": [
"mcp-shrimp-task-manager"
],
"env": {
"DATA_DIR": "<DATA_DIR>",
"ENABLE_THOUGHT_CHAIN": "<ENABLE_THOUGHT_CHAIN>",
"MCP_PROMPT_EXECUTE_TASK_APPEND": "<MCP_PROMPT_EXECUTE_TASK_APPEND>",
"MCP_PROMPT_PLAN_TASK": "<MCP_PROMPT_PLAN_TASK>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"shrimp-task-manager": {
"type": "stdio",
"command": "npx",
"args": [
"mcp-shrimp-task-manager"
],
"env": {
"DATA_DIR": "<DATA_DIR>",
"ENABLE_THOUGHT_CHAIN": "<ENABLE_THOUGHT_CHAIN>",
"MCP_PROMPT_EXECUTE_TASK_APPEND": "<MCP_PROMPT_EXECUTE_TASK_APPEND>",
"MCP_PROMPT_PLAN_TASK": "<MCP_PROMPT_PLAN_TASK>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"shrimp-task-manager": {
"command": "npx",
"args": [
"mcp-shrimp-task-manager"
],
"env": {
"DATA_DIR": "<DATA_DIR>",
"ENABLE_THOUGHT_CHAIN": "<ENABLE_THOUGHT_CHAIN>",
"MCP_PROMPT_EXECUTE_TASK_APPEND": "<MCP_PROMPT_EXECUTE_TASK_APPEND>",
"MCP_PROMPT_PLAN_TASK": "<MCP_PROMPT_PLAN_TASK>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"shrimp-task-manager": {
"command": "npx",
"args": [
"mcp-shrimp-task-manager"
],
"env": {
"DATA_DIR": "<DATA_DIR>",
"ENABLE_THOUGHT_CHAIN": "<ENABLE_THOUGHT_CHAIN>",
"MCP_PROMPT_EXECUTE_TASK_APPEND": "<MCP_PROMPT_EXECUTE_TASK_APPEND>",
"MCP_PROMPT_PLAN_TASK": "<MCP_PROMPT_PLAN_TASK>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"shrimp-task-manager": {
"command": "npx",
"args": [
"mcp-shrimp-task-manager"
],
"env": {
"DATA_DIR": "<DATA_DIR>",
"ENABLE_THOUGHT_CHAIN": "<ENABLE_THOUGHT_CHAIN>",
"MCP_PROMPT_EXECUTE_TASK_APPEND": "<MCP_PROMPT_EXECUTE_TASK_APPEND>",
"MCP_PROMPT_PLAN_TASK": "<MCP_PROMPT_PLAN_TASK>"
}
}
}
}Environment variables
DATA_DIRENABLE_THOUGHT_CHAINMCP_PROMPT_EXECUTE_TASK_APPENDMCP_PROMPT_PLAN_TASK
Replace the placeholders with your own credentials and keep them out of version control.