Magnemo

Magnemo

Memory MCP。AI が記憶し、あなたは大切なものを残せます。

Magnemo は AI のための Memory です。プレーンファイルとして、あなたのコンピューターに保存されます。AI は作業しながら学んだことを書き留めます。あなたが承認するまで、何も Memory にはならず、すべての Memory には、誰が書き、誰が承認したかが表示されます。

エージェントが何かを書き留めると、Magnemo がチャットであなたに尋ねます。ワンクリックです。

サイト · マニュアル · 変更履歴 · X @Magnemo_AI · 既知の制限

1 回の貼り付けでインストール

3 行で完了します。

pip install magnemo      # Python 3.11 or newer
magnemo init             # makes the vault: a folder of plain files
magnemo mount            # writes .mcp.json, the file Claude Code reads

エージェントに任せることもできます。任意のプロジェクトフォルダーで Claude Code を開き、これを貼り付けてください。（magnemo mount の手順で .mcp.json が書き込まれます。これは Claude Code が読み込むファイルです。Cursor、Windsurf、その他のクライアントでは、「クライアントへのインストール」にある各クライアント用のブロックを使用してください。）

Set up Magnemo in this project:
1. Install it: pip install magnemo. It needs Python 3.11 or newer. If pip can't find it, install uv (curl -LsSf https://astral.sh/uv/install.sh | sh) and then run: uv tool install magnemo
2. Initialize the vault: magnemo init
3. Register the MCP server: run magnemo mount — it adds Magnemo to this project's MCP config and keeps any servers already there.
4. Verify: run magnemo doctor and confirm everything passes.
5. Then ask me to restart you, so Magnemo's tools load, and to say this when you are back: "Use Magnemo to remember what this project is."
If anything fails, show me what went wrong and fix it if you can.

種を植えましょう。1 回貼り付けるだけで、エージェントが Memory を育てます。

再起動後、こう伝えてください。Magnemo を使って、このプロジェクトについて記憶してください。 エージェントが 1 行を書き留めると、 Magnemo がチャットで承認を求めます。ワンクリックです。それから、何を記憶しているか尋ねてみてください。

対応クライアント

どのクライアントでも同じ 1 つのサーバーを使います。「テスト済み」と記載されたクライアントでテスト済みです。それ以外は、各クライアントのドキュメントに従ってください。

クライアント	テスト済み	方法
Claude Code	はい：2026 年 10 月 12 日、Claude Code 2.1.296。4 つのツールとチャットでの確認をテストし、ワンクリックでメモを承認できました。	magnemo mount、または claude mcp add magnemo -e MAGNEMO_VAULT=/absolute/path/to/vault -- uvx magnemo-mcp
Claude Desktop	未テスト	最新リリースの magnemo-0.6.9.mcpb を開きます
Cursor	未テスト	下記の Cursor への追加リンク、または .cursor/mcp.json
VS Code	未テスト	.vscode/mcp.json
Windsurf	未テスト	~/.codeium/windsurf/mcp_config.json
Cline	未テスト	cline_mcp_settings.json
Continue	未テスト	~/.continue/config.yaml
Gemini CLI	未テスト	~/.gemini/settings.json
Codex CLI	未テスト	~/.codex/config.toml
Zed	未テスト	settings.json → context_servers

各クライアント用の正確なブロックは、「クライアントへのインストール」にあります。

比較

5 つの質問について、各プロジェクトのドキュメントに基づいて回答しています（2026 年 10 月 12 日に確認し、10 月 22 日に再確認しました。各ページへのリンクは表の下にあります）。

	Magnemo	Mem0	Zep	Letta	Basic Memory
メモリの保存場所	コンピューター上のフォルダーにあるプレーンな Markdown ファイル	Mem0 が運営するホスト型プラットフォーム。オープンソース版では、ローカルの Qdrant ストアと SQLite の履歴ファイル	Zep：マネージドクラウドサービス、または独自の VPC。オープンソースのエンジンである Graphiti：自分で運用するグラフデータベース	エージェントが所有する git リポジトリ内の Markdown ファイル。Letta がホストするか、ローカルモードで自分のデバイスに保存	ディスク上の Markdown ファイルとローカルの SQLite インデックス。オプションのクラウド
書き込みを承認する人	あなたです。エージェントによる書き込みは、あなたの承認を得るまでステージングに保留されます	LLM がメッセージから事実を抽出して保存します。ドキュメントには承認手順の記載はありません	メッセージは届くとすぐにグラフに取り込まれます。ドキュメントには承認手順の記載はありません	エージェントが自分のメモリを更新します。バックグラウンドレビューは「あなたに承認を求めません」	アシスタントがメモを直接書き込みます。クラウドでは、提案された編集を承認または却下できます
各エントリに記録される作成者と承認者	両方。各ファイルのヘッダー（author、reviewed_by）と追記専用の台帳に記録	ユーザー、エージェント、アプリ、実行の ID、タイムスタンプ、各メモリの変更履歴。ドキュメントに承認者フィールドの記載はありません	各事実がいつ有効で、いつ無効になったかを、元のエピソードにたどれる形で記録。ドキュメントに承認者フィールドの記載はありません	メモリの編集はすべて git のコミットになります。ドキュメントにはコミットに何が記録されるか記載されていません	タイトル、種類、タグ、日付。author は追加可能なフィールドです。ドキュメントに承認者フィールドの記載はありません
独自に行うネットワーク呼び出し	ありません。モデル呼び出しも埋め込み呼び出しもありません。バックアップを追加した場合の git push を除きます	モデルと埋め込みにはデフォルトで OpenAI を使用します。Ollama を含む他のプロバイダーも記載されています	Zep はクラウド API です。Graphiti はデフォルトで OpenAI を使用します。ローカルのモデルサーバーについても説明されています	ローカルモードでは状態を自分のデバイスに保持します。推論は、ローカルのものも選べる任意のプロバイダーに送られます	ローカルで動作します。デフォルトの埋め込みは API キーなしで自分のマシン上で実行されます
取り戻せるもの	却下の理由が記録されます。置き換えられたメモは、移動先へのリンクを付けてアーカイブされます。削除は一切されません。ファイルは自由に編集できます	削除、更新、各メモリの履歴。エクスポートはホスト型プラットフォームで利用できます	ノード、エッジ、エピソードを削除できます。置き換えられた事実は削除ではなく無効化されます	メモリの編集履歴はすべて git に記録されます。ファイルは読み取りと編集が可能です	編集や git での追跡が可能なプレーンファイル。削除ツール。クラウドには保存したすべてのバージョンが保持されます

それぞれが優れている点。 Mem0 はメモリを自動で抽出し、意味に基づいて検索します。また、Python と JavaScript の SDK、REST API、ホスト型プラットフォームを提供しています。Zep は各事実がいつ有効だったかを把握できるナレッジグラフを、3 言語の SDK を備えたマネージドサービスとして提供しています。Letta は SDK、CLI、メモリを管理するバックグラウンドエージェントを備えた、エージェント向けの総合プラットフォームです。Basic Memory はマシン上で動作する埋め込みを使ってキーワードと意味の両方で検索し、メモをグラフにリンクして、クラウドを通じて同期します。Magnemo にはそのような機能はありません。検索はキーワード検索のみ（KNOWN_LIMITS.md）で、グラフもホスト型サービスもありません。備えているのは承認と記録です。 各ページ：Mem0 の概要、プラットフォームとオープンソース、追加、履歴、クイックスタート、削除、エクスポート · Zep の概念、事実、セキュリティ、データの削除、Graphiti · Letta のMemFS、メモリー設定、ローカルモード · Basic Memory のREADME、概要、ツール、ノート形式、セマンティック検索、提案、ファイル履歴。表のセルに誤りや古い情報があれば、issue を登録してください。修正します。

掲載先：公式 MCP レジストリ（ai.magnemo/magnemo）· PyPI · mcpservers.org · Glama · awesome-mcp-servers。 テスト済み環境：Python 3.9、3.11、3.12 で、プッシュのたびにテストしています。2026年10月12日時点で300件のテストを実施しています（実行履歴）。

新着情報

• 0.6.9 · 2026年10月22日 · シートは自身のレポートを領収書として提出し、何も尋ねません。承認は Memory に対して行います。Sentinel はシートの引用を引用として読み取ります。
• 0.6.8 · 2026年10月13日 · 承認はチャット内でワンクリックで求められます。エージェントまたはスクリプトが実行する承認は拒否されます。
• 0.6.7 · 2026年10月2日 · magnemo review は保留中およびフラグ付きのノートにラベルを付けます。Sentinel が検出したノートの作成者は、信頼度を得られません。

すべてのリリース：CHANGELOG.md。

開発者向け。 Magnemo は、4つのツール（retrieve、stage、 bootpack、handoff）と、レビュー、昇格、却下を行う CLI を備えた MCP サーバーです。 お使いのマシン上で、ご自身が所有するプレーンな Markdown ファイルを使って動作します。このパッケージはネットワークモジュールをインポートしません（magnemo doctor は実行のたびにスキャンします）。通信が発生するのは、バックアップ先を追加した場合に git push を実行するときだけです。昇格のたびに、エントリーの作成者、承認者として申告された名前、日時、使用されたゲートが記録されます。信頼度はその記録から算出され、自己申告されることはありません。すでにお使いのあらゆるメモリー（ノートのフォルダー、Obsidian、RAG スタックなど）と並べて利用できます。Python 3.11 以降、依存関係ゼロ、Apache-2.0 です。

新しいボルトでは、THE CHARTER セクションに、まだ昇格されていないことが表示されます。これはガバナンスの仕組みです。Magnemo が正典を捏造することはありません。チャーターをステージングしてレビューし、昇格すれば、その後の起動時には毎回、内容がそのまま返されます。 （インストール後に magnemo が見つからない場合、pip のスクリプトフォルダーが PATH に含まれていません。python3 -m magnemo なら常に動作します。）

オープンベータ — 失うわけにはいかないものを任せる前に、KNOWN_LIMITS.md をお読みください。 正直な注意事項を記載しています。細かい条件で隠したりはしません。

クライアントへのインストール

1つのサーバーを10通りの方法で。以下のブロックはすべて同じもので、MAGNEMO_VAULT に Memory を保存するフォルダーを指定して uvx magnemo-mcp を実行します（magnemo init ./vault で作成できます）。記載のあるものはこの Mac でテスト済みです。それ以外は各クライアントのドキュメントに基づいており、未テストと明記しています。修正点があれば、Issue をお寄せください。

Claude Code — テスト済み：Claude Code のセッションでサーバーをマウントし、4つのツールを一覧表示して呼び出し、チャットに質問を表示します（最終実行：2026年10月12日、Claude Code 2.1.296、サーバー 0.6.8）。

claude mcp add magnemo -e MAGNEMO_VAULT=/absolute/path/to/vault -- uvx magnemo-mcp

（claude mcp list に magnemo … ✔ Connected と表示されます。チームで使うためにリポジトリの .mcp.json に書き込むには、-s project を追加してください。） デスクトップアプリしかお持ちでない場合、シェルで claude コマンドを実行できないことがあります。Mac では、アプリは独自のコピーを ~/Library/Application Support/Claude/claude-code/<version>/claude.app/Contents/MacOS/claude に保持しています。claude の代わりに、このパスを指定して実行してください。

Claude Desktop — ここでは最初から最後までの動作確認は未実施です。最新リリースから拡張機能（magnemo-0.6.9.mcpb）をダウンロードして開くと、Claude Desktop が vault フォルダーを尋ね、残りの処理を行います。（承認後にコネクターのディレクトリ一覧が表示されます。）

Cursor — ここでは未テスト（この Mac にはインストールされていません）。リンクと設定ブロックは Cursor のドキュメントに基づいています。 または ~/.cursor/mcp.json（プロジェクト内では .cursor/mcp.json）：

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

VS Code / Copilot — ここでは未テストです。VS Code のドキュメントに基づいています。 またはワークスペース内の .vscode/mcp.json：

{
  "servers": {
    "magnemo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Windsurf — 未テストです。~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Cline — 未テストです。Cline → MCP Servers → Configure → cline_mcp_settings.json：

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" },
      "disabled": false
    }
  }
}

Continue — 未テストです。~/.continue/config.yaml（または .continue/mcpServers/ 内のファイル）：

mcpServers:
  - name: magnemo
    command: uvx
    args: ["magnemo-mcp"]
    env:
      MAGNEMO_VAULT: /absolute/path/to/vault

Gemini CLI — 未テストです。~/.gemini/settings.json：

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Codex CLI — 未テストです。~/.codex/config.toml：

[mcp_servers.magnemo]
command = "uvx"
args = ["magnemo-mcp"]
env = { MAGNEMO_VAULT = "/absolute/path/to/vault" }

Zed — 未テストです。settings.json → context_servers：

{
  "context_servers": {
    "magnemo": {
      "source": "custom",
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

インストール後の流れはどこでも同じです。エージェントがステージングに書き込み、あなたが確認します。

magnemo yes             # promote the top of the queue (yes <id-fragment> · yes --all)
magnemo no <id> --reason "…"   # reject one — the reason is required; rejections teach
magnemo review          # the interactive queue, when you want to read first
magnemo doctor          # python, vault, config, ledger, and the mount — scans the package for network modules too

stdio 経由の MCP に対応するものなら、どれでも同じ方法でマウントできます。リモート接続（ChatGPT やホスト型クライアント）には、0.7.0 で対応予定です。

仕組み

「はい」の確認を徹底します。「はい」がなければ Memory には何も追加されず、エンジンは人の「はい」とエージェントの「はい」を区別できます。

Magnemo は憲章を備えた Memory です。すべての事実に来歴が付与され、エージェントによる書き込みは Memory になる前に必ずレビューキューで確認され、すべての決定が Trust Ledger に記録されます。

エージェントが使える動詞は4つです。承認はその中にありません。 「はい」を決めるのはあなたです。Magnemo がチャットで尋ね、あなたの回答がエージェントを経由することはありません。KNOWN_LIMITS.md では、この仕組みで防げることと防げないことを説明しています。docs/MCP.md には、対応クライアントを記載しています。

実行者	接続口	できること
エージェント	MCP サーバー（stdio）	retrieve で正規メモリーを取得 · stage → ステージング専用、唯一の書き込みツール · 起動時に bootpack · 境界で handoff
あなた	CLI + git（任意のエディター）	キューを確認 · 昇格／却下 · 任意の内容を編集 · すべてを所有

依存関係ゼロ。 Python 標準ライブラリのみを使用し、Python 3.11 以降が必要です。ほかにインストールするものはなく、このコード以外に信頼するものもありません。

Vault

vault/
  dev/      knowledge/ playbooks/ decisions/ debt/        ← example: a dev team's partition
  ops/      knowledge/ playbooks/ clients/ decisions/ style/  ← example: an ops team's partition
  shared/   tickets/ changelog/                            ← interop bus (gated)
  _staging/   agent writes await review here
  _index/     machine-managed
  _ledger/    trust_ledger.jsonl — append-only, never forgets

すべてのノートは、出典を示すフロントマター（author、written、source、status、reviewed_by、supersedes、strength）を含む Markdown です。出典情報がファイル形式です。

プライバシー

Memory は、お使いのコンピューター上にある、開いて確認できるプレーンなファイルです。独自にネットワーク通信を行うことはありません。バックアップ先を追加すると、そこにのみプッシュされます。 正確には、このパッケージはネットワークモジュールをインポートせず、magnemo doctor は実行のたびにネットワークモジュールをスキャンします。バックアップ先を追加すると、エンジンはそこに git push を実行します。詳細はこちら：https://magnemo.ai/privacy

保証（フェーズ 1 — 統制された想起）

• MCP サーバー経由では、エージェントによる書き込みが正規ストアに直接反映されることは決してありません。常にステージングのみです。
• 検索で返されるのは、正規の（昇格済み）ノートのみです。ステージング中のノートは検索されません。ブートパックには、ステージング済みとしてマークされた内容が表示されます。未完了スレッドと、ステージング中の上位ノートのタイトル、および最後の引き継ぎの切り取り位置と、そのノートへのポインターです。
• エージェントごとにパーティションの壁が適用されます（MAGNEMO_PARTITIONS）。パーティションをまたぐ操作は拒否されます。
• 置き換えは明示的に行われます。古いノートは、前方へのリンクを付けてアーカイブされます。削除されるものはありません。
• 却下は保持・記録されます。却下から学びます。
• すべての昇格・却下は、実行者と理由を添えて追記専用の Trust Ledger に記録されます。

テスト

python -m unittest discover -s tests -v     # incl. full MCP round-trips (legacy + four-verb)
# or: pip install -e ".[test]" && pytest

同じテストスイートが、Python 3.9、3.11、3.12 で、プッシュのたびに実行されます：実行結果。

リリース済みのすべて

リリースごとの履歴と、かつてここに掲載されていた設計ノート：CHANGELOG.md。

— Silver Valley Technologies Inc. · 3 フェーズ中のフェーズ 1 · 学習するメモリーは 統制されるメモリーです。

---

mcp-name: ai.magnemo/magnemo · ソース · セキュリティ · プライバシー