Notes

Notes — AI が書き込むノート

Notes のための日次箇条書きノートです。Claude Code プラグインとして、ほかのすべてのクライアント向けの単体 Agent Skill として、また、読み取りに対応したあらゆるもの向けのプレーンな MCP URL として利用できます。

AI は自ら進んで、あなたのノートブックにメモを残します。今日のページに書き込み、あなたが書いたものと同じエンティティグラフにタグ付けし、誰が書いた箇条書きかいつでもわかるように記します。数週間後にプロジェクトのページを開くと、あなたのメモとプロジェクトのメモが日付順に同じページに並んでいます。そして次のセッションではそれを読み返すので、同じ説明を繰り返す必要はありません。

これはメモリデータベースではありません。ベクトルインデックスも、削除ポリシーも、フックも、Postgres の持ち込みもありません。メモリは、すでに読んでいるノートブックに書かれた箇条書きです。手作業で修正でき、作成元の会話へのリンクも付いています。

インストール

Claude Code

/plugin marketplace add jpwilliams/notes-skill
/plugin install notes@notes-skill

Cursor、VS Code、Codex、Gemini CLI、Antigravity、Amp、OpenCode、Warp…

ここでは、これらのクライアントがオープンな Agent Skills 形式を読み取り、それぞれ独自の MCP サーバー URL を使うため、スキルと接続は別々になっています。

gh skill install jpwilliams/notes-skill

これにより、共通のベンダー中立なパスである .agents/skills/ にインストールされるため、どのクライアントを使う場合でもコマンドは 1 つです。（GitHub CLI を使わない場合は、npx skills add jpwilliams/notes-skill でも同じことができます。）次に、MCP サーバーを追加します。

https://notes.jpwilliams.dev/api/v1/mcp

その他すべて

リモート MCP に対応したクライアントなら、パッケージもインストールも不要で、その URL を直接使えます。残りの設定はクライアントが自動で検出します。notes.jpwilliams.dev/install に、クライアントごとの手順があります。

どの方法を選んでも、その後の流れは同じです

ブラウザーが開きます。すでにお持ちのアカウントにサインインし、接続によって可能になる操作を確認して、名前を付けてください。その名前は、AI が書き込むすべての箇条書きに表示されるため、1日のメモを読み返すときに目にしたい名前にしてください。「Work laptop」のほうが「Claude」より適しています。

設定はこれだけです。キーの発行も貼り付けも不要で、キーチェーンも、claude mcp add も URL も必要ありません。notes.jpwilliams.dev の 🔑 Machine access ページからいつでも接続を解除でき、解除するとすぐに使えなくなります。

デスクトップアプリとウェブサイトでの利用

プラグインを使わずに、同じ接続を利用できます。URL https://notes.jpwilliams.dev/api/v1/mcp を使って、Notes をカスタムコネクターとして追加します。アプリが残りの設定を自動で検出し、承認して名前を付けるための同じ画面を表示します。ターミナルでは、ノートブックを使うタイミングを Claude に教えるスキルが含まれるため、プラグインを使う価値があります。コネクター単体にはツールと、サーバー自体が送信する、同じガイダンスを短くまとめたものが含まれます。

できること

4 つのツールと、それらを使うタイミングをエージェントに教えるスキルがあります。

ツール	機能
list_entities	棚です。すべてのプロジェクト、人、トピックを、最近言及されたものから順に表示します。
get_entity	1 つのエンティティのページです。説明、サブ箇条書き付きの最近の言及、関連して出現する項目、未完了の ToDo を表示します。
get_day	ある 1 日のページを Markdown で表示し、ID 付きの箇条書きも返します。
append_note	ある日のページに箇条書きを追加します。

意図的にできないこと

• 追記のみです。 テキスト、ほかのエージェントのテキスト、自分自身のテキストを編集または削除することはできません。訂正は新しい箇条書きとして追加します。そもそもノートとはそういうものです。
• 既存のエンティティのみです。 存在しないエンティティを示す #tag があると、黙って無視せず、呼び出し全体を拒否します。名前の変更や統合にはまだ対応していないため、タイプミスをすると、実際に読むインデックスに誤った項目が恒久的に残ります。プロジェクトのエンティティは、手動で一度作成します。
• コーパス検索はできません。 読み取りは上限ではなく構造によって制限されています。そのため、プロジェクトを読むコストは、10年分のノートでも1か月分でも変わりません。

読み取る内容

ノートブック全体です。すべての日付、すべてのエンティティ、すべてのToDoに加え、会議の文字起こしから抜き出したノートも含まれます。同意画面で承認する内容はこれであり、そこにもそのとおりに記載されています。

許可されているのは追記と読み取りだけです。これは、モデルが守るかどうかわからないツールの説明文としてではなく、データの読み取り時にサーバー側で強制されます。

表示される内容

エージェントが書き込んだ箇条書きはすべて、**日別表示に表示され、**その接続に付けた名前でマークされます。ホバーすると、認証情報、書き込んだ時刻、エージェントが自身について伝えた内容（ベンダー、モデル、元となった会話）を確認できます。後者の情報には、エージェントによる自己申告であることが明記されます。名前とタイムスタンプはアプリ側で記録されます。だからこそ、アプリに自分で名前を付けさせるのではなく、あなたが名前を付けます。

マークには書き込み元が記録され、消えることはありません。 エージェントの箇条書きを手動で編集しても、それがあなたのものになるわけではありません。内容を整えるのはよくあることで、最初に触れた時点でマークが消える仕様なら、大半のマークは1週間以内に消えてしまいます。訂正するには箇条書きを削除します。

エージェントを含めずに日別表示を読みたい場合は、🔑 Machine accessに切り替えスイッチがあります。非表示にした実行は、該当箇所に件数が残るため、何も書き込まれなかったかのように日別表示に記録されることはありません。同じページにはすべての接続が一覧表示され、接続をすぐに切断できます。すでに書き込まれたノートはそのまま残り、あなたが付けた名前のマークも保持されます。

必要なもの

Notesアカウント。アプリはnotes.jpwilliams.devから利用できます。

ライセンス

MIT。