@stithy/memory
v0.4.0
Published
Cross-session persistent memory MCP server with semantic search, automatic decay, and dedup
Maintainers
Readme
@stithy/memory
Stop re-explaining context to your AI. Stithy Memory remembers everything across sessions, every tool, every project.
A polished cross-session memory MCP server for Claude, Cursor, Windsurf, and Claude Code. 100% local — your data never leaves your machine.
$6.99/month via the MCP Marketplace. 30-day refund, no questions asked.
What you get
- Semantic search that finds the right memory, not just keyword matches
- Auto-dedup — store the same fact twice, it merges instead of cluttering
- Auto-decay — old, low-importance memories prune themselves so search stays sharp
- Soft-delete with trash — accidental deletes are recoverable
- Bulk import/export — your data, always portable
- Auto-categorize — your AI suggests tags for untagged memories
- Consolidate — surfaces related memories you can merge
- One-command install across Claude Desktop, Cursor, Windsurf, Claude Code
- 100% local — embeddings + storage on your device, no telemetry, no servers
- Actively maintained — bug fixes within 7 days
Install (30 seconds)
npx -y @stithy/memory installThis detects every MCP-compatible AI client on your machine and writes the config. Restart the client and you're done.
License key
After purchasing on the marketplace you'll get a license key starting with mcp_live_.... Set it as MCP_LICENSE_KEY in your environment, or paste it into your MCP client's env vars block. Without a valid key the server refuses to start.
export MCP_LICENSE_KEY="mcp_live_..."Or in your client config:
{
"mcpServers": {
"stithy-memory": {
"command": "npx",
"args": ["-y", "@stithy/memory"],
"env": { "MCP_LICENSE_KEY": "mcp_live_..." }
}
}
}The installer wires this up automatically when you provide your key.
Use
In any chat with your AI:
"Remember that I prefer pnpm over npm for all my projects." "Remember the Postgres prod URL is in 1Password under 'prod-db', not in .env." "What did I tell you about the auth refactor last week?"
The AI will call store_memory and search_memory automatically.
Tools
| Tool | What it does |
|---|---|
| store_memory | Save a fact, decision, or context. Auto-dedupes. |
| search_memory | Semantic search across all memories. |
| list_memories | Browse chronologically, optionally by tag. |
| get_memory | Retrieve a single memory by id. |
| update_memory | Edit an existing memory. |
| delete_memory | Move a memory to trash (recoverable). |
| restore_memory | Restore from trash. |
| list_trash | Show recoverable deletions. |
| purge_trash | Permanently delete old trash. |
| list_tags | All tags with usage counts. |
| decay_memories | Prune old, low-importance memories (dry-run by default). |
| memory_stats | Total count + storage size + tag count. |
| bulk_import | Import from JSON array. |
| bulk_export | Export everything to JSON. |
| auto_categorize | Have your AI tag untagged memories. |
| consolidate_memories | Find clusters to merge. |
Configuration
| Env var | Default | What |
|---|---|---|
| MCP_LICENSE_KEY | — | Required. Marketplace license key. |
| STITHY_MEMORY_DB | ~/.stithy/memory.db | SQLite database path |
How it works
- SQLite with
sqlite-vecfor vector storage and FTS5 for keyword fallback - Embeddings:
Xenova/all-MiniLM-L6-v2(384 dimensions, runs locally via@xenova/transformers) - Dedup: cosine similarity > 0.95 triggers merge instead of insert
- Decay: configurable TTL filtered by importance and tags, with dry-run safety
- Soft-delete: deletes go to a trash table for 30+ days
License
Source-available under Business Source License 1.1. Free for non-production use up to 7 days; production use requires a $6.99/mo subscription. Auto-converts to Apache 2.0 on 2028-04-12.
Support
- Email: [email protected]
- Issues: https://github.com/resolceo-ai/stithy-mcp/issues
- Bug fixes shipped within 7 days. 30-day refund, no questions asked.
