Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Toolbox Lending MCP Server What's out on loan from my toolbox and when is it due back?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A beginner-friendly MCP server (Model Context Protocol) for the household toolbox. Track your tools and consumables, keep a lend-a-tool ledger (who borrowed what, when it came home), get maintenance nudges by interval, turn project gap lists into a shopping list, and receive seasonal tune-up prompts.
Built by Asdale Dynamics, LLC as part of Dylan Asdale's easy, friendly AI tools — plain English, local-first, no cloud required.
Standard library only. No pip installs, no API keys, no network calls. Your toolbox stays on your machine as simple JSON you can open in any editor.
Tool | What it is for |
| Tools and consumables (hand tools, power tools, drill bits, glue). List, add, update, remove, and check what is running low. |
| The lend-a-tool ledger: who has it, when it left, when it came home. Gentle nudges when something is due or overdue. |
| Repeating chores by interval — sharpen blades (~90 days), oil and battery checks (~90–540 days). Marking done moves the next date out. |
| Say what a project needs; the server compares against the inventory and hands back a gap list that doubles as a shopping list. |
| Month-appropriate prompts, like sharpening things in spring and bringing batteries inside before winter. |
| One friendly snapshot: counts, loans out, low stock, what's due. |
Related MCP server: HomeBoxMCP
Requirements: Python 3.10+ (nothing else).
# Run the test suite (offline, no network)
python3 -m pytest
# Start the server (it speaks JSON over stdin/stdout — you don't do this by hand)
python3 -m toolbox_mcpOn first run the server seeds gentle sample data — a claw hammer, a
cordless drill, a project, one almost-due loan — so there is something to
play with. Everything is saved to data/toolbox.json, with automatic backups
in data/backups/ before every change.
Add to your MCP client's config (e.g. Claude Code):
{
"mcpServers": {
"toolbox": {
"command": "python3",
"args": ["-m", "toolbox_mcp"],
"cwd": "/path/to/toolbox-lending-mcp-server"
}
}
}Setting | Meaning | Default |
| The directory the JSON store is allowed to live in | current directory |
| The |
|
Path safety: the server refuses any store path that could escape the
TOOLBOX_DATA_DIR — no .. segments, no absolute paths outside it, no
symlink tricks, nothing inside backups/. A hostile prompt cannot point it
at your other files.
Before every save, the previous file is copied to
data/backups/toolbox.json.<timestamp>.bak.json (kept: 10 newest). If the
main file is ever corrupted, the server reloads the newest good backup on the
next start.
Paste this into a shell to see the handshake and one real tool call:
printf '%s\n%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"toolbox_seasonal","arguments":{"action":"prompt","month":10}}}' \
| python3 -m toolbox_mcpYou should see two JSON lines: the MCP handshake and an October tune-up prompt.
"What's out on loan from the toolbox and when is it due back?"
"What maintenance is overdue?" (blades, oil, batteries)
"I want to build a picture-frame shelf — what do I need to buy?"
"What should I do to the toolbox this month?"
Everything the assistant says is plain sentences: "Claw hammer is now out on loan to Neighbor Sam. Hoping to see it back by 2026-11-03." No jargon walls, no dashboards. And nothing leaves your machine.
python3 -m pytest # 64 tests, fully offlineThe suite covers the MCP handshake, every tool action, persistence and backup recovery, and a set of security cases (path traversal, symlinks, absolute escapes, backups-dir protection).
home-maintenance-mcp-server — the repair and fix-it side of the house
checklists-mcp-server — general-purpose household checklists
MIT — see LICENSE. Copyright (c) 2026 Asdale Dynamics, LLC.
This server cannot be deployed
Track tools, equipment and assets: inventory and asset management, assign, report, set up by chat.
Track subscriptions and renewals from your AI chat: schedules, due dates, reminders, local data.
Homeowner's AI: view & update appliances, warranties, documents & maintenance for your home.
Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.
