Skip to main content
Glama
jpwilliams
by jpwilliams

Notes — AIが書き込むノートブック

Notes のための日次バレットノートブック — Claude Code プラグインとして、他のすべてのクライアント向けのスタンドアロン Agent Skill として、そして何でも読み取るためのプレーンな MCP URL として。

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

これはメモリデータベースではありません。ベクターインデックスも、退避ポリシーも、フックも、独自の 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 にクライアントごとの手順があります。

どのルートを選んでも、次に起こること

ブラウザが開きます。すでに持っているアカウントにサインインし、接続が何ができるかを読み、名前を付けます — その名前が、それが書くすべてのバレットに表示されます。だから、一日のメモの途中で読みたいと思うものにしてください。「仕事用ラップトップ」は「Claude」より優れています。

これでセットアップは完了です。発行するキーも、貼り付けるキーも、キーチェーンも、claude mcp add も、URL もありません。いつでも notes.jpwilliams.dev の 🔑 マシンアクセス ページから切断でき、すぐに動作を停止します。

Related MCP server: GoLogX (logx-mcp)

デスクトップアプリとウェブサイトについて

同じ接続ですが、プラグインはありません。Notes をカスタムコネクタとして追加し、URL https://notes.jpwilliams.dev/api/v1/mcp を使用します — アプリは残りを見つけ、承認して名前を付ける同じ画面に送ります。プラグインはターミナルで持つ価値があります。なぜなら、Claude がノートブックに手を伸ばすタイミングを教えるスキルを運ぶからです。コネクタ単体は、ツールと、サーバー自身が送る同じガイダンスの短いバージョンを運びます。

できること

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

ツール

機能

list_entities

棚:すべてのプロジェクト、人物、トピック。最近言及された順。

get_entity

1つのエンティティのページ — その説明、サブバレット付きの最近の言及、共起するもの、未完了の TODO。

get_day

1日のページをマークダウンとして、ID 付きのバレットも。

append_note

日にバレットを追加。

意図的にできないこと

  • 追記のみ。 編集や削除は一切できません — あなたのテキストも、他のエージェントのものも、自分自身のものも。修正は新しいバレットであり、それはノートブックが本来やることです。

  • 既存のエンティティのみ。 存在しないエンティティを指す #tag は、黙って無視されるのではなく、呼び出し全体を拒否します。名前の変更とマージはまだ存在しないので、タイプミスは、実際に読むインデックスに永久的な間違った棚を作ることになります。プロジェクトのエンティティは、手で一度作成します。

  • コーパス検索なし。 すべての読み取りは、上限ではなく形状によって制限されます。これにより、プロジェクトの読み取りコストは、1か月分のメモでも10年分のメモでも同じになります。

読み取るもの

ノートブック全体 — すべての日、すべてのエンティティ、すべての TODO、会議の文字起こしから抽出されたメモを含みます。それが同意画面で承認する内容であり、その言葉で明記されています。

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

表示されるもの

エージェントが書くすべてのバレットは、日次ビューに表示され、 その接続に付けた名前でマークされます。ホバーすると、資格情報、書いた瞬間、エージェントが自分自身について言ったこと — ベンダー、モデル、元の会話 — が表示されます。これら最後のものは自己申告であり、そのようにラベル付けされています。名前とタイムスタンプは私たちのものであり、アプリケーションが自分自身に名前を付けるのではなく、あなたが名前を付ける理由がまさにそこにあります。

マークは起源を記録し、決して消えません。 エージェントのバレットを手で編集しても、あなたのものにはなりません — 整理することは通常のケースであり、最初の接触で消えるマークは、1週間以内にほとんどから消えてしまうでしょう。バレットを削除することが修正のジェスチャーです。

もしそれらなしで一日を読みたいなら、🔑 マシンアクセスにスイッチがあります。非表示の実行は、あった場所にカウントを残すので、一日が静かに何も書かれなかったふりをすることはありません。同じページにすべての接続がリストされ、1つを即座に切断できます — すでに書かれたメモは、付けた名前でマークされたまま、正確にそこに残ります。

必要条件

Notes アカウント。アプリは notes.jpwilliams.dev にあります。

ライセンス

MIT。

Maintenance

ActivityStale
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.
    5 npm
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Tamper-evident audit logging for AI agents. Append-only, hash-chained, optionally Ed25519-signed log. The MCP server lets an agent keep and verify a record of what it actually did.
    8
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that lets AI agents read and write a self-hosted TriliumNext knowledge base over its ETAPI, enabling note capture, structured table maintenance, and search.
    5
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for managing a local, domain-agnostic knowledge base using Markdown notes with frontmatter. Enables AI agents to capture, read, search, link, and maintain notes with atomic writes and privacy controls.
    13
    MIT