MemoryTool

A native macOS app that provides persistent, cross-session memory for AI assistants.
Tell Claude something once — every future session knows it.

What It Does

MemoryTool combines a SwiftUI GUI for human management with an embedded MCP server that AI tools (Claude Code, Claude Desktop) use to store and retrieve memories via stdio transport.

┌───────────────────────────────────────────────────────┐
│                   MemoryTool.app                      │
│                                                       │
│  ┌──────────────┐         ┌───────────────────────┐   │
│  │   SwiftUI    │         │   MCP Server (stdio)  │   │
│  │   GUI        │         │                       │   │
│  │  CRUD +      │         │  remember (dedup)     │   │
│  │  Search      │         │  recall (hybrid)      │   │
│  │  Tag Mgmt    │         │  forget / update      │   │
│  └──────┬───────┘         └──────┬────────────────┘   │
│         └──────────┬─────────────┘                    │
│          ┌─────────┴──────────┐                       │
│          │  SQLite + FTS5     │                       │
│          │  + Embeddings      │                       │
│          │  (WAL mode)        │                       │
│          └────────────────────┘                       │
└───────────────────────────────────────────────────────┘
       ↑                               ↑
     User                         Claude Code

Features

Core

• 6 MCP Tools: remember, recall, forget, update_memory, list_categories, get_memory
• Native macOS GUI: Three-column NavigationSplitView — categories, memory list, detail editor
• Multi-Process Safe: GUI and MCP server share one SQLite file via WAL mode
• Tags & Categories: Flexible organization with many-to-many tag relationships
• Import/Export: JSON and Markdown export for backup and portability
• One-Click Install: ./install.sh builds, installs, and configures Claude Code automatically

Search (V1.1)

• Hybrid Search: Combines FTS5 keyword matching with semantic vector similarity
• Semantic Embeddings: Apple NLContextualEmbedding (system BERT, 768-dim, zero external dependencies)
• CJK Full-Text: FTS5 trigram tokenizer — supports Chinese, English, Japanese, Korean
• Weighted Ranking: Four-factor scoring — keyword relevance + semantic similarity + recency decay (30-day half-life) + access frequency

Intelligence (V1.1)

• Semantic Deduplication: Cosine similarity > 0.85 detects paraphrases (e.g. "我爱吃火锅" vs "用户爱吃火锅") and merges content automatically
• Access Tracking: Records access count and last accessed time for ranking
• Orphan Cleanup: Deleting a memory automatically removes unused tags

Requirements

• macOS 15.0+ (Sequoia)
• Xcode 16+ / Swift 6.0+
• Claude Code (for MCP integration)

Quick Start

Option 1: One-Click Install

git clone https://github.com/yuanyunfan/MemoryTool.git
cd MemoryTool
./install.sh

This builds the MCP server, symlinks it to ~/.memorytool/bin/, and configures Claude Code automatically.

Option 2: Manual Setup

1. Build:

   swift build -c release --product MemoryMCP
   

2. Install binary:

   mkdir -p ~/.memorytool/bin
   ln -sf "$(pwd)/.build/release/MemoryMCP" ~/.memorytool/bin/MemoryMCP
   

3. Configure Claude Code — add to ~/.claude/settings.json under mcpServers:

... View full README on GitHub