@hermitsh/shrimp-mcp

MCP server for SHrimp — the task manager agents control.

Deeply nested task trees, batch ops, real-time phone sync, AI prompt passthrough. Works instantly with zero setup — no account, no API key, no phone required.

Quick Start

Install and use immediately (local mode)

claude mcp add shrimp -- npx @hermitsh/shrimp-mcp

That's it. Tasks are stored locally at ~/.shrimp/tasks.json. Start creating tasks right away — no pairing, no account, no phone needed.

Add to Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "shrimp": {
      "command": "npx",
      "args": ["@hermitsh/shrimp-mcp"]
    }
  }
}

Upgrade to cloud sync (optional)

Pair with the SHrimp iOS app to sync tasks to your phone in real-time:

npx @hermitsh/shrimp-mcp pair

Open SHrimp on your phone → Settings → Agent → Pair New Agent → enter the 6-digit code.

Hosted endpoint (zero install)

claude mcp add --transport http shrimp https://hermitshell.ai/mcp

Two Modes

| | Local Mode | Paired Mode | |---|---|---| | Setup | Zero — just install | Pair with iOS app | | Storage | ~/.shrimp/tasks.json | Cloud + phone sync | | Task tools | All 11 tools | All 11 tools | | Phone features | — | Pipeline, inbox, prompt config, push notifications | | Limits | 500 tasks, 200 ops/day | Unlimited | | Cost | Free | Free |

Tools (19 total)

Tasks (9 tools) — work in both modes | Tool | Description | |------|-------------| | shrimp_get_tasks | Read the full task tree with filters | | shrimp_search | Search tasks by keyword | | shrimp_add_task | Create a new task (any nesting depth) | | shrimp_update_task | Update task title, notes, due date, category | | shrimp_complete_task | Toggle task completion | | shrimp_archive_task | Archive a task and children | | shrimp_restore_task | Restore an archived task | | shrimp_move_task | Reparent or reorder a task | | shrimp_delete_task | Permanently delete a task |

Batch (1 tool) — works in both modes | Tool | Description | |------|-------------| | shrimp_batch | Execute up to 50 operations at once |

Connection (2 tools) | Tool | Description | |------|-------------| | shrimp_status | Check connection mode (local or paired) | | shrimp_pair | Pair with a SHrimp account via 6-digit code |

Settings (4 tools) — paired mode only | Tool | Description | |------|-------------| | shrimp_get_prompt | Read prompt template sections | | shrimp_update_prompt | Update prompt sections | | shrimp_get_provider | Read AI provider configuration | | shrimp_update_provider | Update AI provider settings |

Pipeline & Inbox (2 tools) — paired mode only | Tool | Description | |------|-------------| | shrimp_pipeline | Read device activity log | | shrimp_inbox | Read incoming items from email, shares, etc. |

Feedback (1 tool) — works in both modes | Tool | Description | |------|-------------| | shrimp_feedback | Submit feedback to the SHrimp team |

What makes SHrimp different

• Zero-friction start — install and go. No account signup, no API key, no phone required
• Unlimited nesting depth — build complex project hierarchies, not flat lists
• Batch ops — create an entire project plan in one call (up to 50 ops)
• Local-first — tasks stored on your machine, works offline, zero latency
• Optional cloud sync — pair with the iOS app when you want phone notifications and cross-device access
• Free — no subscription, no API key fees
• Personal-first — designed for individual use, not team/enterprise overhead

Development

npm install
npm run build    # compile TypeScript
npm run dev      # development with auto-reload
npm start        # run compiled server (stdio)

License

Proprietary — © Hermit Shell. All rights reserved.