Skip to content
Back to search

packing-list-mcp-server

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/opencode-projects-atlasrearden8--packing-list-mcp-server/badge.svg)](/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
  1. # packing-list-mcp-server
  2. A small, local-first MCP (Model Context Protocol) server that keeps reusable
  3. packing lists in a plain JSON file on your own machine. No accounts, no cloud,
  4. no personal data - just simple categories (toiletries, electronics, meds,
  5. kids' items) and trip templates (weekend, hospital visit, conference) that
  6. make packing for the next trip a two-step job instead of a brain scramble.
  7. Built to be ADHD-friendly: nothing to remember, everything reusable, and
  8. "what's left" is always one tool call away.
  9. By [Asdale Dynamics, LLC](https://dylanasdale.github.io) - beginner-friendly AI
  10. tools, written like a friend would.
  11. ## What it does
  12. - **Reusable categories**: built-in checklists for `toiletries`, `electronics`,
  13. `meds`, and `kids-items`, each a ready-made template you can merge into any trip.
  14. - **Trip templates**: built-in starters for `weekend`, `hospital-visit`, and
  15. `conference`; save any list you make as a new template for next time.
  16. - **Add and tick**: add items to a list and tick them off as you pack, with a
  17. live progress count and "what's left" view.
  18. - **Local-first storage**: everything lives in one JSON file
  19. (`~/.packing-list-mcp-server/packing-lists.json` by default). No network
  20. calls, no telemetry, no personal-data fields - items are just text, a simple
  21. category string, and a done flag.
  22. ## Tools
  23. | Tool | What it does |
  24. | --- | --- |
  25. | `create_list` | Make a new empty packing list |
  26. | `add_item` | Add an item (optionally with a category); creates the list on the fly |
  27. | `tick_item` | Tick an item as packed (`done=false` unticks) |
  28. | `remove_item` | Take an item off the list |
  29. | `whats_left` | Show only the unpacked items, with a progress count |
  30. | `show_list` | Show the whole list grouped by category |
  31. | `list_all_lists` | Show every packing list and how packed each is |
  32. | `save_as_template` | Save a list as a reusable template (ticks reset) |
  33. | `create_list_from_template` | Start a new list from any template |
  34. | `add_template_to_list` | Merge a template (e.g. `meds`) into an existing list |
  35. | `list_templates` | Show all available templates |
  36. | `delete_template` | Remove a template you no longer want |
  37. ## Setup
  38. Requires Node.js 20+.
  39. ```bash
  40. npm install
  41. ```
  42. ## Run
  43. ```bash
  44. npm start
  45. ```
  46. The server speaks MCP over stdio, so you point your MCP client (Claude
  47. Desktop, Codex, opencode, etc.) at it. Example client config:
  48. ```json
  49. {
  50. "mcpServers": {
  51. "packing-lists": {
  52. "command": "node",
  53. "args": ["/path/to/packing-list-mcp-server/server.mjs"]
  54. }
  55. }
  56. }
  57. ```
  58. Optional: set `PACKING_LIST_DATA_DIR` (a folder) or `PACKING_LIST_DATA_FILE`
  59. (a full path) to choose where the JSON file lives. It defaults to
  60. `~/.packing-list-mcp-server/packing-lists.json`.
  61. Then try things like: "Start a weekend list for the cabin, merge in the kids
  62. items," or "What's left to pack?"
  63. ## Test
  64. ```bash
  65. npm test # unit + integration tests
  66. npm run smoke # launches the real server over stdio and exercises tools
  67. ```
  68. ## Where it fits
  69. Distinct from our `errand-runs-mcp-server` (today's errands and stops) and
  70. `free-travel-planner-kit` (routes and free-tier travel planning). This one is
  71. purely about the **packing checklist**, saved so the next trip starts from a
  72. proven list.
  73. ## Privacy
  74. No personal data, no secrets, no analytics. The data file stores item text, a
  75. category label, and a done flag - nothing else. Keep the data file wherever
  76. you like; it is never transmitted anywhere.
  77. ## License
  78. MIT - see [LICENSE](LICENSE). Copyright (c) 2026 Asdale Dynamics, LLC.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.