memex

memex

Claude Code の各セッションは、前回作ったもの――変更したファイル、決めたこと、問題が起きたこと――を知らない状態から始まります。あなたは説明し直し、Claude は読み直し、また最初からやり直します。

memex はすべてのセッションを構造化して記録します。Claude は次のセッションの開始時にその記録を読み込みます。

クラウドは不要です。LLM による抽出もありません。保存ごとの料金もかかりません。ローカルの SQLite と、インストール用の 1 つのコマンドだけです。

インストール

# with uv
uvx mcp-memex install

# with pip
pip install mcp-memex
memex install

Claude Code を再起動すれば完了です。

保存される内容

各エントリは、単なるテキストの塊ではなく、構造化されています。

mem_save(
    task="Replaced JWT auth with session cookies",
    files=["src/auth.py", "src/middleware.py"],
    decisions=["Session cookies over JWT - simpler, no token refresh needed"],
    warnings=["Redis required - app won't start without REDIS_URL set"],
    tags=["auth", "sessions"]
)

Claude は、意味のある作業を終えたときに mem_save を呼び出します。「今やったことを保存して」と伝えるだけでもかまいません。

セッション開始時に Claude が確認する内容

=== memex: session context (db: my_project.db) ===

--- Recent (2) ---
[1] #4 - 2026-06-14T10:32
  Task      : Replaced JWT auth with session cookies
  Files     : src/auth.py, src/middleware.py
  Decision  : Session cookies over JWT - simpler, no token refresh needed
  Warning   : Redis required - app won't start without REDIS_URL set
  Tags      : auth, sessions

[2] #3 - 2026-06-13T15:10
  Task      : Added rate limiting to /api/login
  Files     : src/middleware.py
  Warning   : Rate limiter is in-memory per process - resets on restart
  Tags      : auth, rate-limiting

Claude は各セッションの開始時に mem_load を自動的に呼び出します。直近のエントリに加え、キーワードとファイルパスから現在の作業に一致するエントリを返します。

ターミナルから閲覧する

履歴を確認するために、Claude の中にいる必要はありません。

memex status                     # entry count, DB size, top tags
memex list                       # recent entries for this project
memex list --tag auth            # filter by tag
memex list --since 7d            # entries from the last 7 days
memex list --since 2026-06-01 --until 2026-06-15  # date range
memex search "rate limit"        # full-text search
memex version                    # print installed version

Markdown にエクスポートする

履歴を、持ち運び可能で人が読みやすいメモに変換します。エントリごとに 1 つの .md ファイルを作成し、関連するエントリやファイルを結ぶ [[wikilinks]] と、#hashtags としてのタグが含まれます。Obsidian や [[links]] を理解するツールで利用できます。

memex export ./my-project-notes/

タグまたは変更されたファイルを共有するエントリは、関連項目セクションで相互リンクされるため、プロジェクトの履歴をグラフとしてたどれます。

6 つの MCP ツール

ツール	機能
mem_load	セッション開始時に呼び出されます。直近のエントリと関連するエントリを返します
mem_save	意味のある作業の後に、構造化されたエントリを保存します
mem_update	既存のエントリの特定のフィールドを更新します（ID とタイムスタンプは維持されます）
mem_search	すべてのエントリを全文検索します
mem_list	エントリを一覧表示します。タグで絞り込むこともできます
mem_delete	ID を指定して、古くなったエントリを削除します

CLAUDE.md だけではだめなのですか？

CLAUDE.md は、アーキテクチャ、規約、テストの実行方法など、変更の少ない静的なプロジェクトドキュメント向けです。セッションの状況に応じた内容は扱いません。

memex は、セッションごとに変わる内容を記録します。昨日作ったもの、今朝決めたこと、1 時間前に見つけた警告などです。「プロジェクトの概要」と「前回何があったか」の違いです。

memex install は Claude の指示を .claude/CLAUDE.local.md に書き込みます。このファイルは Claude Code が自動的に読み込むため、プロジェクト独自の CLAUDE.md に触れることはありません。

メモリはプロジェクトごとに分離されます

各プロジェクトには、作業ディレクトリを基準とした ~/.memex/<project>.db に独自の SQLite データベースが作成されます。異なるプロジェクトのセッションが混ざることはありません。

設定

デフォルト値を変更する必要がある場合は、~/.claude.json の MCP env ブロックに設定します。

変数	デフォルト値	説明
MEMEX_DIR	~/.memex	データベースの保存先
MEMEX_GLOBAL	0	1 に設定すると、すべてのプロジェクトで 1 つのデータベースを共有します
MEMEX_RECENT	5	セッションごとに読み込む直近のエントリの最大数
MEMEX_MATCHED	5	セッションごとに読み込む FTS 検索一致エントリの最大数

アンインストール

memex remove
pip uninstall mcp-memex

メモリのデータベースは ~/.memex/ に残ります。すべて削除する場合は、このディレクトリを手動で削除してください。

要件

• Python 3.10+
• mcp パッケージ（自動的にインストールされます）
• FTS5 を備えた SQLite（Python 3.8 以降に標準搭載）
• Claude Code CLI

ライセンス

MIT