@hermitsh/shrimp-mcp

@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.