Bear Notes MCPサーバー

あらゆるAIアシスタントからBearノートを検索、読み取り、作成、更新できます。ワンクリックでインストール可能なClaude Desktop拡張機能として、またあらゆるMCPクライアント向けのスタンドアロンなnpmパッケージとして利用可能です。

このローカル専用MCPサーバーは、高速検索とOCRサポートのためにBearのSQLiteデータベースを読み取り、書き込みにはBearのネイティブAPIを使用します。完全なプライバシー：外部接続は一切なく、すべての処理はMac上で行われます。

プロンプトの例：

私たちの会話を要約して、新しいBearノートを作成して

私のサイドプロジェクトのアイデアについてインタビューして、重要なポイントをBearノートに記録して

「製品ローンチ」ノートの構成を見直すのを手伝って

ブログ記事のアイデアをブレインストーミングしよう — 最高のものをBearノートに保存して、進めながら洗練させていこう

✨ 主な機能

• 13個のMCPツール：ノートの検索、読み取り、作成、更新、タグ付け、アーカイブに対応

• OCR検索 — 添付された画像やPDF内のテキストを検索

• 日付ベースの検索 — 相対的な日付（「昨日」、「先週」、「先月の初め」など）に対応

• タグ管理 — タグをツリー形式で表示、タグなしノートの検索、ノートへのタグ追加

• 新しいノートの規約（オプトイン） — タグを末尾ではなくタイトルの直後に配置

• コンテンツの置換（オプトイン） — ノートの本文全体または特定のセクションを置換

• ローカル専用 — ネットワーク通信は一切なく、すべてのデータはMac内に保持

📦 インストール

Claude Desktop拡張機能

前提条件：Bearアプリがインストールされており、Claude Desktopがインストールされている必要があります。

1. Releasesから最新の bear-notes-mcpb-*.mcpb 拡張ファイルを入手します。

2. Claude Desktopが起動していることを確認します（起動していない場合は起動してください）。

3. 拡張ファイルをダブルクリックします。Claude Desktopにインストールプロンプトが表示されます。

   何らかの理由でダブルクリックが機能しない場合は、Claude -> Settings -> Extensions -> Advanced Settings -> 「Install Extension」をクリックしてください。

4. 完了です！

Claudeに「Bearノートで『会議』を検索して」のように尋ねると、応答にノートが表示されるはずです！

スタンドアロンMCPサーバー

このBear Notes MCPサーバーをClaude Code、Cursor、Codex、その他のAIアシスタントで使用したい場合：

要件：Node.js 24.13.0以上

Claude Code（1コマンド）

claude mcp add bear-notes --transport stdio -- npx -y bear-notes-mcp@latest

その他のAIアシスタント

MCP設定ファイルに追加してください：

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"]
    }
  }
}

その他のインストールオプションとローカル開発環境のセットアップ — NPM.md

🛠️ ツール

• bear-open-note - 添付画像やPDFのOCRテキストを含む、Bearノートの全文を読み取ります

• bear-create-note - タイトル、コンテンツ、タグを指定して、Bearライブラリに新しいノートを作成します

• bear-search-notes - テキストコンテンツの検索、タグや日付範囲によるフィルタリングでノートを見つけます。添付ファイルのOCR検索を含みます

• bear-add-text - Bearノートの先頭または末尾、あるいはヘッダーで識別される特定のセクション内にテキストを挿入します

• bear-replace-text - 既存のBearノートのコンテンツ（本文全体または特定のセクション）を置換します。設定でコンテンツ置換を有効にする必要があります。

• bear-add-file - 既存のBearノートにファイルを添付します。ローカルファイルパス（推奨）またはbase64エンコードされたコンテンツを提供してください。

• bear-list-tags - Bearライブラリ内のすべてのタグを、ノート数を含む階層ツリーとしてリスト表示します

• bear-find-untagged-notes - Bearライブラリ内でタグが割り当てられていないノートを見つけます

• bear-add-tag - 既存のBearノートに1つ以上のタグを追加します

• bear-archive-note - Bearノートをアーカイブし、削除せずにアクティブなリストから除外します

• bear-rename-tag - Bearライブラリ内のすべてのノートにわたってタグの名前を変更します

• bear-delete-tag - ノートに影響を与えずに、Bearライブラリ内のすべてのノートからタグを削除します

• bear-grab-url - WebページをBearノートとして保存します。Bearがページを取得し、Markdownに変換します。

⚙️ 設定

デバッグログ

トラブルシューティングのために詳細ログを有効にします。

• Claude Desktop: Settings → Extensions → Configure (Bear Notesの横) → 「Debug Logging」をオン → Save → Claudeを再起動

• スタンドアロンMCPサーバー: 環境変数 UI_DEBUG_TOGGLE=true を設定

新しいノートの規約

デフォルトでは、API経由で作成された場合、Bearはノートの末尾にタグを配置します。このオプションを有効にすると、タグをタイトルの直後に配置し、水平線で区切るようになります。

┌──────────────────────────────┐
│ # Meeting Notes              │  ← Note title
│ #work #meetings              │  ← Tags right after title
│                              │
│ ---                          │  ← Separator
│                              │
│ Lorem Ipsum...               │  ← Note body
└──────────────────────────────┘

• Claude Desktop: Settings → Extensions → Configure (Bear Notesの横) → 「New Note Convention」をオン → Save → Claudeを再起動

• スタンドアロンMCPサーバー: 環境変数 UI_ENABLE_NEW_NOTE_CONVENTION=true を設定

規約を有効にしたスタンドアロン設定の例：

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "true"
      }
    }
  }
}

コンテンツの置換

bear-replace-text ツールを有効にして、既存のノートのコンテンツ（本文全体またはヘッダー下の特定のセクション）を置換できるようにします。

• Claude Desktop: Settings → Extensions → Configure (Bear Notesの横) → 「Content Replacement」をオン → Save → Claudeを再起動

• スタンドアロンMCPサーバー: 環境変数 UI_ENABLE_CONTENT_REPLACEMENT=true を設定

コンテンツ置換を有効にしたスタンドアロン設定の例：

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_CONTENT_REPLACEMENT": "true"
      }
    }
  }
}

技術的な詳細

このサーバーは、検索/読み取り操作のためにBear NotesのSQLiteデータベースを直接読み取り、書き込み操作にはBearのX-callback-URL APIを使用します。すべてのデータ処理はローカルマシン上で行われ、外部ネットワークへの呼び出しは一切ありません。

サポートされているプラットフォーム

macOSのみ（BearデスクトップアプリがmacOSでのみ動作するため）。

ログ

Claude Desktop:

• MCPサーバーのログは ~/Library/Logs/Claude/main.log に出力されます（bear-notes-mcp を検索してください）

• MCPトランスポートのログは ~/Library/Logs/Claude/mcp-server-Bear\ Notes.log に出力されます

スタンドアロンMCPサーバー:

• ログはstderrに出力されます。UI_DEBUG_TOGGLE=true でデバッグログを有効にしてください

FAQ

データが盗まれる可能性はありますか？

ありません。サーバーはBearのローカルデータベース（Bearアプリが表示しているものと同じデータ）を読み取り、BearのネイティブAPIを使用してノートにテキストを追加するだけです。ネットワーク送信や外部サーバーへの通信は一切ありません。

なぜBearアプリのx-callback-url APIだけでなくSQLiteを使うのですか？

読み取り操作（検索/開く）において、x-callback-url APIは x-success レスポンスでノートデータを返します。これにはレスポンスを処理するためのサーバーやカスタムバイナリが必要となり、リスクが高く不安定です。SQLiteへの直接の読み取り専用アクセスの方が、ノートの検索や読み取りにおいてよりシンプルで信頼性が高いためです。

なぜサードパーティパッケージではなくネイティブのNode.js SQLiteを使うのですか？

サードパーティのnodeパッケージからSQLiteバイナリを出荷することを避けるためです。これはサプライチェーンのリスクを伴い、Claude Desktop拡張機能がmacOS上で動作するのを妨げる原因となります。

AnthropicはサードパーティのSQLiteバイナリに署名していないため、macOSのセキュリティシステムが「Anthropicによって署名されたClaudeプロセスが、サードパーティによって署名された別のバイナリを実行しようとしている」とフラグを立ててしまいます。その結果、Claude Desktopは拡張機能を実行できなくなります。

拡張機能をインストールする際、「インストールするとコンピュータ上のすべてにアクセスできるようになります」という赤い警告が表示されますが、これはどういう意味ですか？

これは、この拡張機能がMac上のBear SQLiteデータベースにアクセスする必要があるという事実に対して、Claude for Desktopが反応しているものです。

Claudeの警告システムは、特定の1つのファイルへのアクセスが必要な場合（この拡張機能が行うこと）と、すべてのファイルへのアクセスが必要な場合を区別しません。

これを検証する方法の1つは、拡張機能をインストールする前に、Claudeにコードベース（非常に小さいです）を分析してもらい、内容を確認することです。

バグ報告や貢献はどうすればよいですか？

IssueやDiscussionsを使用してください！フィードバックや提案、このプロジェクトをより良くするための助けを歓迎します！❤️

最新情報の入手

新しいバージョンがリリースされたときに通知を受け取るために、リリース通知の購読を検討してください：

新しいリリースがあるときは reddit.com/r/bearapp/ にも投稿しています。