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 分