shelvd-mcp
# shelvd-mcp: idea parking MCP server for Claude Code
[](https://www.npmjs.com/package/shelvd-mcp)
[](https://www.npmjs.com/package/shelvd-mcp)
[](LICENSE)
Park ideas from your AI tool and pick them up later. Shelvd is a local, private [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for Claude Code, Cursor and other MCP clients: a to-do and idea backlog that lives in your AI assistant. Your ideas stay in a JSON file on your machine, and nothing is sent anywhere.
**npm:** [npmjs.com/package/shelvd-mcp](https://www.npmjs.com/package/shelvd-mcp)
## Install
Claude Code:
```
claude mcp add shelvd -- npx -y shelvd-mcp
```
Any other MCP client: run `npx -y shelvd-mcp` as a stdio server.
## Use
Talk to your assistant:
- "Park an idea: add dark mode, remind me friday 3pm"
- "List my ideas"
- "Snooze the dark mode idea until next week"
- "Mark 6ebe83 done"
## Tools
| Tool | What it does |
| --- | --- |
| `park_idea` | Save an idea with an optional due date (natural language works), project, details and context (repo, branch, files, summary). |
| `list_ideas` | Show ideas as a table. Filter by `project`, `status` (`parked`, `due`, `snoozed`, `done`, `all`), `from`/`to` dates and `limit`. |
| `get_idea` | Show one idea with its context, notes and history. |
| `update_idea` | Edit title, details, project or due date, or append a `note`. Only the fields you give change. |
| `search_ideas` | Find ideas by text in title, details, project and notes. |
| `start_idea` | Load an idea's details, context and notes as a brief, so the assistant can start work on it. |
| `complete_idea` | Mark an idea done. |
| `snooze_idea` | Move the due date later, using `until` (date text) or `minutes`. |
| `delete_idea` | Permanently delete one idea by id. |
| `clear_ideas` | Delete many ideas by scope: `done`, `all` or `project:<name>`. Previews first; only deletes with `confirm=true`. |
## Due-idea reminders at session start
The server mentions ideas that are due or overdue in the first reply of a session. To also see them from a Claude Code `SessionStart` hook, run:
```
npx -y shelvd-mcp hook
```
It prints a snippet to paste into `~/.claude/settings.json`. Shelvd never edits that file for you.
## Where data lives
Ideas are stored in `~/.shelvd/ideas.json` (directory `0700`, file `0600`). Set `SHELVD_DIR` to use another directory.
If the file is corrupt, Shelvd leaves it untouched and reports the error. Fix or move the file, then retry.
## Limits
- Two clients writing in the same millisecond can drop one write (no file lock).
- Phone reminders (`nagEveryMinutes`) need the hosted Pro version.
## Links
- npm: https://www.npmjs.com/package/shelvd-mcp
- Source and issues: https://github.com/NiharRan/shelvd-mcp
Keywords: MCP server, Model Context Protocol, Claude Code, idea parking, idea tracker, backlog, to-do, reminders, snooze, notes, local-first, privacy.
TDQS
Scored across 10 tools
Most tools have clearly distinct purposes: create, retrieve, update, complete, snooze, delete, bulk-clear, and search are all separable. The main mild overlap is between get_idea and start_idea, since both retrieve an idea's context, though start_idea is framed as a workflow brief. list_ideas vs search_ideas is also close but still distinguishable by whether the user wants all ideas or a text query.
All tools follow a consistent snake_case verb_noun pattern: park_idea, list_ideas, get_idea, complete_idea, start_idea, snooze_idea, delete_idea, clear_ideas, update_idea, search_ideas. The naming is predictable and easy to scan.
Ten tools is well-scoped for an idea-parking workflow: core CRUD, lifecycle actions, bulk cleanup, and search are all represented without obvious padding. Each tool maps to a meaningful operation.
The surface covers the full idea lifecycle: create, list, get, update, start, complete, snooze, delete, bulk delete, and search. Minor gaps include no explicit reopen/uncomplete operation and no restore for deleted ideas, but most workflows can be handled with the existing tools.