Upnote Lens Mcp

upnote-lens-mcp

UpNote のノートを AI アシスタントが扱えるようにする、ハイブリッド MCP サーバーです。

• 🔍 ノートの検索 — タイトルと本文を対象に、キーワードでノートを検索します。
• 📖 読み取りと要約 — 実際のノート本文を返すため、AI が書いた内容を要約、分析したり、質問に回答したりできます。
• ✍️ チャットから新しいノートを作成します。

内部では、読み取りにはローカルの UpNote SQLite データベースを使用し（読み取り専用）、実際の内容をテキストとして返します。書き込みには upnote:// URL スキーム（x-callback-url）を使用し、データベースには一切触れません。

書き込み側（URL スキーム）は chadthornton/upnote-mcp（MIT）を基にしています。

使い方

登録が完了したら、AI アシスタントに普段の言葉で話しかけるだけです。適切なツールが選ばれるため、コマンドや構文を覚える必要はありません。たとえば、次のように使えます。

• 「Q3 のロードマップに関する UpNote のノートを要約して。」
• 「Postgres のチューニングについて触れたノートを探して、要点を抜き出して。」
• 「先月、オンボーディングについて何を書いた？」
• 「最近のノートを5件表示して。」
• 「今日の3つの優先事項を含む、『Standup 6/4』というタイトルのノートを作成して。」

読み取り、検索、要約、作成はすべて、自然な会話を通じて行われます。

要件

• macOS — 完全にサポートされ、動作確認済みです。
• Windows — ベストエフォートでの対応です。URL は登録済みのスキームハンドラーから開かれ、デフォルトの DB パスは %APPDATA%\UpNote\ 配下と推定されます。このパスは作者によって動作確認されていません。読み取りに失敗する場合は、UPNOTE_LENS_DB を設定してください（下記参照）。
• Python 3.10 以降（または、Python を同梱する uv）。
• UpNote デスクトップアプリがインストールされていること。

インストールと登録

🤖 AI にインストールを任せる（最も簡単）

MCP クライアント（Claude など）に llms-install.md へのリンクを渡すと、手順が実行され、すべて設定されます。

🧑 自分でインストールする

現在の環境に合う最初の選択肢を選んでください。各選択肢には、Claude への登録方法も記載されています。

Claude Desktop の設定ファイル（各選択肢で参照）：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

オプション1 — uv を使用（推奨）

uv を一度インストールする必要があります （brew install uv、または curl -LsSf https://astral.sh/uv/install.sh | sh）。 その後はパッケージのインストールは不要です。uvx が必要に応じて upnote-lens-mcp をダウンロード、キャッシュし、実行します。

Claude Code：

claude mcp add upnote-lens -- uvx upnote-lens-mcp

Claude Desktop：

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["upnote-lens-mcp"] } } }

オプション2 — pip を使用（uv がない場合）

pip install upnote-lens-mcp

Claude Code：

claude mcp add upnote-lens -- upnote-lens-mcp

Claude Desktop：

{ "mcpServers": { "upnote-lens": { "command": "upnote-lens-mcp" } } }

オプション3 — HTTPS 経由で GitHub からインストール（pip がない場合）

PyPI/pip を使用できない場合は、uv を使ってリポジトリから直接インストールします。（uv がまだインストールされていない場合は、curl -LsSf https://astral.sh/uv/install.sh | sh を実行してください。）

Claude Code：

claude mcp add upnote-lens -- uvx --from git+https://github.com/AwesomeHye/upnote-lens-mcp upnote-lens-mcp

Claude Desktop：

{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["--from", "git+https://github.com/AwesomeHye/upnote-lens-mcp", "upnote-lens-mcp"] } } }

ツール

読み取り（ローカル DB に問い合わせ → 実際のテキストを返す）

ツール	説明
search_notes(query, limit=20)	タイトルと本文を対象に部分一致検索します。ID、タイトル、更新日時、抜粋を返します
get_note(note_id, include_html=False)	ノートのタイトルと本文の全文を返します（オプションで生の HTML も取得できます）
list_recent(limit=20)	更新日時が新しいノートを一覧表示します
list_notebooks()	ノートブックを、ノート数と親ノートブックとともに一覧表示します
list_notes_in_notebook(notebook_id, limit=50)	ノートブック内のノートを一覧表示します
list_tags()	タグをノート数とともに一覧表示します
list_notes_by_tag(tag_title, limit=50)	指定したタグが付いたノートを一覧表示します

書き込み（upnote:// URL スキーム）

ツール	説明
create_note(title, content, notebook?, markdown=True, new_window=False)	ノートを作成します。content はデフォルトで Markdown です。notebook は名前で照合されます。タグは設定できません（下記を参照）
open_note(note_id, new_window=False)	アプリで既存のノートを開きます
open_notebook(notebook_id)	アプリでノートブックを開きます

タグに関する制限：UpNote の note/new URL スキームにはタグ用のパラメーターがありません。また、本文に入力したハッシュタグは通常のテキストのままで、本物のタグにはなりません（エディターに入力した場合にのみタグに変換されます）。タグが必要な場合は、ノートの作成後にアプリで手動で追加してください。

DB のパスを上書きする

データベースがデフォルトの場所にない場合（または Windows をお使いの場合）は、環境変数でパスを指定してください。

UPNOTE_LENS_DB=/path/to/upnote.sqlite3

デフォルトのパス：

• macOS：~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3
• Windows（推定）：%APPDATA%\UpNote\upnote.sqlite3

ライセンス

MIT。LICENSE を参照してください。 書き込み側の URL スキームの形式と起動方法は、chadthornton/upnote-mcp（MIT）を参考にしています。