# Ferret

Ferret — an MCP server for Claude Code and Cursor that connects your self-hosted home inventory to AI assistants.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22 repo stars
- Author: ferret-project
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ferret-project/ferret
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ferret

## What it 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.

## Requirements
- Needs: Docker
- Remote server: `https://{ferret_host}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http ferret https://{ferret_host}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add ferret --url https://{ferret_host}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ferret": {
            "url": "https://{ferret_host}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ferret": {
            "type": "http",
            "url": "https://{ferret_host}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http ferret https://{ferret_host}/mcp
```

## When to use it
- 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
- Where did we put the tent?
- What maintenance is due this month?

## Similar
- [EquipDash](https://affpapa.org/en/nevibecode/mcp/equipdash.md) — MCP server · 4381 installs
- [lightspeed-ecom](https://affpapa.org/en/nevibecode/skills/lightspeed-ecom.md) — skill · 207 installs
- [mcp-vtex](https://affpapa.org/en/nevibecode/mcp/mcp-vtex.md) — MCP server · ★ 279 repo stars
- [mcp-tiny](https://affpapa.org/en/nevibecode/mcp/mcp-tiny.md) — MCP server · ★ 279 repo stars
- [homebox-mcp](https://affpapa.org/en/nevibecode/mcp/homebox-mcp.md) — MCP server · ★ 19 repo stars
- [Crossmart](https://affpapa.org/en/nevibecode/mcp/crossmart.md) — MCP server · ★ 2 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
