Back to search
packing-list-mcp-server
MCP serverGitHub
A small, local-first MCP (Model Context Protocol) server that keeps reusable
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/opencode-projects-atlasrearden8--packing-list-mcp-server)HTML
<a href="/listings/opencode-projects-atlasrearden8--packing-list-mcp-server"><img src="/api/listings/opencode-projects-atlasrearden8--packing-list-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Requires Node.js 20+.
npm install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 102 lines
- # packing-list-mcp-server
- A small, local-first MCP (Model Context Protocol) server that keeps reusable
- packing lists in a plain JSON file on your own machine. No accounts, no cloud,
- no personal data - just simple categories (toiletries, electronics, meds,
- kids' items) and trip templates (weekend, hospital visit, conference) that
- make packing for the next trip a two-step job instead of a brain scramble.
- Built to be ADHD-friendly: nothing to remember, everything reusable, and
- "what's left" is always one tool call away.
- By [Asdale Dynamics, LLC](https://dylanasdale.github.io) - beginner-friendly AI
- tools, written like a friend would.
- ## What it does
- - **Reusable categories**: built-in checklists for `toiletries`, `electronics`,
- `meds`, and `kids-items`, each a ready-made template you can merge into any trip.
- - **Trip templates**: built-in starters for `weekend`, `hospital-visit`, and
- `conference`; save any list you make as a new template for next time.
- - **Add and tick**: add items to a list and tick them off as you pack, with a
- live progress count and "what's left" view.
- - **Local-first storage**: everything lives in one JSON file
- (`~/.packing-list-mcp-server/packing-lists.json` by default). No network
- calls, no telemetry, no personal-data fields - items are just text, a simple
- category string, and a done flag.
- ## Tools
- | Tool | What it does |
- | --- | --- |
- | `create_list` | Make a new empty packing list |
- | `add_item` | Add an item (optionally with a category); creates the list on the fly |
- | `tick_item` | Tick an item as packed (`done=false` unticks) |
- | `remove_item` | Take an item off the list |
- | `whats_left` | Show only the unpacked items, with a progress count |
- | `show_list` | Show the whole list grouped by category |
- | `list_all_lists` | Show every packing list and how packed each is |
- | `save_as_template` | Save a list as a reusable template (ticks reset) |
- | `create_list_from_template` | Start a new list from any template |
- | `add_template_to_list` | Merge a template (e.g. `meds`) into an existing list |
- | `list_templates` | Show all available templates |
- | `delete_template` | Remove a template you no longer want |
- ## Setup
- Requires Node.js 20+.
- ```bash
- npm install
- ```
- ## Run
- ```bash
- npm start
- ```
- The server speaks MCP over stdio, so you point your MCP client (Claude
- Desktop, Codex, opencode, etc.) at it. Example client config:
- ```json
- {
- "mcpServers": {
- "packing-lists": {
- "command": "node",
- "args": ["/path/to/packing-list-mcp-server/server.mjs"]
- }
- }
- }
- ```
- Optional: set `PACKING_LIST_DATA_DIR` (a folder) or `PACKING_LIST_DATA_FILE`
- (a full path) to choose where the JSON file lives. It defaults to
- `~/.packing-list-mcp-server/packing-lists.json`.
- Then try things like: "Start a weekend list for the cabin, merge in the kids
- items," or "What's left to pack?"
- ## Test
- ```bash
- npm test # unit + integration tests
- npm run smoke # launches the real server over stdio and exercises tools
- ```
- ## Where it fits
- Distinct from our `errand-runs-mcp-server` (today's errands and stops) and
- `free-travel-planner-kit` (routes and free-tier travel planning). This one is
- purely about the **packing checklist**, saved so the next trip starts from a
- proven list.
- ## Privacy
- No personal data, no secrets, no analytics. The data file stores item text, a
- category label, and a done flag - nothing else. Keep the data file wherever
- you like; it is never transmitted anywhere.
- ## License
- MIT - see [LICENSE](LICENSE). Copyright (c) 2026 Asdale Dynamics, LLC.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.