Mcp Bear

io.github.jkawamoto由 GitHub 帳號 jkawamoto 發布v0.5.2更新於 Oct 24, 2026

A MCP server for interacting with Bear note-taking software.

已驗證STDIO僅桌面效率與工作流

概覽

AI 產生的概覽

讓助手在 macOS 上的 Bear 筆記軟體中讀取、建立、搜尋、加上標籤、封存與刪除筆記。

可以做什麼
這是一個本機 MCP 伺服器，透過 Bear 的 X-callback-url 機制操作 Bear 筆記軟體。支援的動作包括開啟筆記、建立筆記、加入文字與檔案、列出標籤、開啟、重新命名與刪除標籤，以及列出未加標籤、待辦、今日與已鎖定筆記、搜尋、移至垃圾桶、封存與抓取網址。它以本機程序透過 stdio 執行，供桌面使用。
適用情境
當你希望 AI 助手在 Mac 上處理既有的 Bear 筆記庫時使用，例如記錄筆記、搜尋內容或整理標籤。請注意本專案已封存，且 Bear 自 v2.8 起內建原生 MCP 伺服器，因此對較新的 Bear 版本而言，這個獨立伺服器已無必要。
執行需求
需要已安裝 Bear 的 macOS 桌面環境，以及執行該套件的本機執行環境（uv/uvx，或 Claude Desktop 的 .mcpb 套件）。必須透過 BEAR_API_TOKEN 環境變數或 --token 參數提供 Bear API 權杖。不使用遠端端點。
安裝前請注意
此伺服器需要 BEAR_API_TOKEN 密鑰，可存取你的 Bear 筆記，請勿放入共享設定檔。其動作可以建立、重新命名、封存、移至垃圾桶與刪除筆記及標籤，因此會更動真實的筆記庫。本專案已封存，已被 Bear 原生 MCP 伺服器取代。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Bear，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[!NOTE] This repository is archived. As of v2.8, Bear now includes a native MCP server implementation, making this standalone server unnecessary.

Bear MCP Server

[uv] [Python Application] [pre-commit] [GitHub License]

A MCP server for interacting with Bear note-taking software.

[Bear MCP Server Icon]

Installation

[!NOTE] You'll need uv installed on your system to use uvx command.

goose

Open this link

goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN

to launch the installer, then click "Yes" to confirm the installation. Set BEAR_API_TOKEN environment variable to your api token.

Manually configuration

You can also directly edit the config file (~/.config/goose/config.yaml) to include the following entry:

yaml
extensions:  bear:    name: Bear    cmd: uvx    args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]    envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" }    enabled: true    type: stdio

For more details on configuring MCP servers in Goose, refer to the documentation: Using Extensions | goose.

Claude

Download the latest MCP bundle mcp-bear.mcpb from the Releases page, then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.

Manually configuration

You can also manually configure this server for Claude Desktop. Edit the claude_desktop_config.json file by adding the following entry under mcpServers:

json
{  "mcpServers": {    "bear": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/jkawamoto/mcp-bear",        "mcp-bear",        "--token",        "<YOUR_TOKEN>"      ]    }  }}

After editing, restart the application.

For more information, see: Connect to local MCP servers - Model Context Protocol.

LM Studio

To configure this server for LM Studio, click the button below.

[Add MCP Server bear to LM Studio]

Actions Implemented

The server supports the following actions. Refer to Bear's X-callback-url Scheme documentation for details on each action.

  • /open-note
  • /create
  • /add-text (partially, via the replace_note and add_title method)
  • /add-file
  • /tags
  • /open-tag
  • /rename-tag
  • /delete-tag
  • /trash
  • /archive
  • /untagged
  • /todo
  • /today
  • /locked
  • /search
  • /grab-url

License

This application is licensed under the MIT License. See the LICENSE file for more details.

來源：README.md，提交 14b511f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.5.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分