Ferret — Claude Code MCP server: what it does, how to install
Ferret — an MCP server for Claude Code and Cursor that connects your self-hosted home inventory to AI assistants.
MIT ★ 22 updated 2026-11-16
Open on GitHubWhat Ferret does
Ferret links AI assistants to your household inventory of belongings, receipts, warranties, and maintenance items via an MCP endpoint at /mcp. The server runs locally inside a Docker container backed by SQLite, featuring encrypted file storage and multi-user households. Connecting requires a running Ferret instance with a configured public URL and an API key generated in the settings.
What it helps with
- find household items by name or description through chat
- add new purchases with receipts and prices to inventory
- update consumable stock and keep shopping lists synchronized
- check upcoming maintenance schedules and warranty deadlines
Example prompts for the agent
- Where did we put the tent?
- What maintenance is due this month?
How to install Ferret
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http ferret https://{ferret_host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add ferret --url https://{ferret_host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"ferret": {
"url": "https://{ferret_host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"ferret": {
"type": "http",
"url": "https://{ferret_host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http ferret https://{ferret_host}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Ferret
How to install Ferret in Claude Code?
Run the command claude mcp add --transport http ferret https://{ferret_host}/mcp in your terminal with the correct host address.
What does Ferret do?
It provides an MCP interface so AI assistants can query your home inventory, add items, manage shopping lists, and check maintenance schedules.
What is needed to run Ferret?
You need a running Docker deployment of Ferret with an accessible MCP URL and an authentication bearer token generated from your household settings.