upnote-mcp

upnote-mcp は、stdio 経由で SQLite からローカルの UpNote データを読み取るための読み取り専用 MCP サーバーです。

これは非公式プロジェクトであり、UpNote とは提携、承認、またはメンテナンスされていません。

機能

• search_notes: タイトル、本文、またはサマリーでノートを検索します

• list_recent_notes: 最近更新されたノートを一覧表示します

• list_notes_this_week: 今週中に更新されたノートを一覧表示します

• list_notes_this_month: 今月中に更新されたノートを一覧表示します

• find_notes: 期間、キーワード、タグフィルターを1回の呼び出しで組み合わせます

• open_note: ノートIDでUpNoteアプリ内のノートを開きます

• get_note: ノートIDでノートの全内容を取得します

• open_notebook: ノートブックIDでUpNoteアプリ内のノートブックを開きます

• list_notebooks: ノート数を表示してノートブックを一覧表示します

• create_note: UpNoteの公式URLスキームを通じて新しいノートを作成します

• list_tags: タグを一覧表示します

• search_by_tag: タグのノートを一覧表示します

このプロジェクトは意図的に読み取り専用です。UpNoteデータベースに書き込むことはありません。 安全なノート作成と開く操作は、直接データベースに書き込む代わりに、UpNoteの公式URLスキームを通じて実行されます。

Related MCP server: upnote-lens-mcp

パッケージ名

このパッケージは @bellx2/upnote-mcp として公開される予定です。

必要条件

• macOS

• サーバーを実行するマシンに bun がインストールされていること

• UpNoteデスクトップアプリがインストールされていること

• デフォルトのUpNoteデータベースパス:

~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3

データベースが別の場所にある場合は、UPNOTE_DB を設定してください。

インストール

bun install

実行

bun run start

通常の使用では、公開パッケージを推奨します:

bunx @bellx2/upnote-mcp

または:

npx @bellx2/upnote-mcp

npx のサポートは依然として bun がインストールされていることに依存します。このパッケージは bun:sqlite などのBun固有のAPIを使用するためです。

ファイル監視を使用した開発の場合:

bun run dev

環境変数

• UPNOTE_DB: upnote.sqlite3 への絶対パス

例:

export UPNOTE_DB="$HOME/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3"

権限

初回実行時、MCPクライアントはコマンド実行とローカルファイルアクセスのための権限プロンプトを表示する場合があります。

これはサーバーが以下のことを行うため、予期される動作です:

• bun を通じて起動する

• ローカルのUpNote SQLiteデータベースを読み取る

• open_note、open_notebook、または create_note のためにUpNoteアプリを開く可能性がある

これらの権限を拒否すると、ノートの検索と取得は機能しません。アクセスを許可した後、Cursor または Claude Desktop でMCPサーバーを再起動する必要がある場合があります。

MCP 設定例

推奨: 公開パッケージ

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

ローカル開発チェックアウト

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

ワークフロー例

次のようなプロンプトを試してください:

• Search UpNote for "travel" and show me the first result

• Show me my 10 most recent UpNote notes

• Show me this week's notes

• Show me this month's notes

• Find this week's AI notes

• Find this month's notes tagged meeting

• List my UpNote tags and open the note that matches the tag "meeting"

• Find notes about "launch", summarize them, and create a new UpNote note with the summary

• List notebooks and open the one named "Research"

ツールリファレンス

search_notes

入力:

{
  "query": "travel",
  "limit": 5
}

list_recent_notes

入力:

{
  "limit": 10
}

list_notes_this_week

入力:

{
  "limit": 20
}

list_notes_this_month

入力:

{
  "limit": 20
}

find_notes

入力:

{
  "period": "this_week",
  "query": "AI",
  "limit": 10
}

または:

{
  "period": "this_month",
  "tag": "meeting",
  "limit": 10
}

get_note

入力:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_note

入力:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_notebook

入力:

{
  "id": "3f03c742-1270-4d35-a5bc-c7d98580d6fc"
}

list_notebooks

入力:

{}

list_tags

入力:

{}

search_by_tag

入力:

{
  "tag": "meeting",
  "limit": 5
}

create_note

入力:

{
  "title": "Meeting Notes",
  "text": "# Summary\n\nDraft created by MCP.",
  "markdown": true,
  "newWindow": false
}

検証

bun run check
bun run smoke

日本語 README

以前の日本語READMEは README_ja.md にあります。