SHrimp Tasks
MCP skill for SHrimp — the task manager agents control.
Works instantly with zero setup. Install and start managing tasks — no account, no API key, no phone required. Tasks are stored locally. Optionally pair with the iOS app for cloud sync and push notifications.
Setup
claude mcp add shrimp -- npx @hermitsh/shrimp-mcp@1.0.6
That's it. To upgrade to phone sync later:
npx @hermitsh/shrimp-mcp@1.0.6 pair
Privacy: In local mode, all data stays at ~/.shrimp/tasks.json on your machine. An anonymous daily ping (no user data) tracks usage. Paired mode requires a one-time 6-digit code from the SHrimp iOS app — no passwords or API keys stored.
Tools (19)
Work in both local and paired mode:
- 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
- shrimp_batch — Execute up to 50 operations at once
- shrimp_feedback — Submit feedback to the SHrimp team
- shrimp_status — Check connection mode (local or paired)
- shrimp_pair — Pair with a SHrimp account via 6-digit code
Paired mode only (requires iOS app):
- 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
- shrimp_pipeline — Read device activity log
- shrimp_inbox — Read incoming items from email, shares, etc.
What makes it different
- Zero-friction start — no signup, no API key, works immediately
- Unlimited nesting depth — complex project hierarchies, not flat lists
- Batch ops — up to 50 operations at once
- Local-first storage — fast, offline, private
- Optional cloud sync via the SHrimp iOS app
- Free, personal-first, no subscription