Bear App MCP Server

MCP文档知识

提供方 bigjeager

文档知识 未标注 Token 社区 / 第三方 Claude DesktopClaude

一个与Bear App集成的MCP服务器,提供笔记创建、搜索、标签管理等功能,适用于AI助手与笔记应用的交互。

一句话选型结论

按资料字段整理

Bear App MCP Server 属于文档知识类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 14 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量14暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

笔记管理JavaScript本地部署标签管理搜索功能AI集成内容生成

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 14 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 14 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Bear App MCP Server当前 14 未标注 未标注 无 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bigjeager上游标注的维护方 bigjeager
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.7 KB
来自项目仓库与上游目录的原文,未做删改

Bear App MCP Server

A Model Context Protocol (MCP) server that provides integration with Bear App using its X-callback-URL scheme. This server enables AI assistants to interact with Bear notes, create new content, search, and manage tags.

Features

  • Note Management: Create, open, and modify notes with full metadata retrieval
  • Text Operations: Add, append, prepend, or replace text in existing notes
  • Search: Search through notes and tags with complete result data
  • Tag Management: Get, open, rename, and delete tags with real-time data
  • Organization: Archive, trash, and organize notes
  • Web Content: Grab content from URLs to create notes with returned metadata
  • Special Views: Access Today, Todo, and Untagged note collections with full note lists
  • Callback Integration: Advanced x-success callback support for comprehensive data retrieval
  • Silent Operation: Custom URL scheme prevents unwanted browser windows during callbacks

Requirements

  • macOS (Bear App is macOS only)
  • Bear App installed and running
  • Node.js 18+
  • Bear API token (for some operations)

Quick Installation```bash

chmod +x ./setup.sh && ./setup.sh


## Manual Installation

1. Clone and go to the project:```bash
git clone https://github.com/bigjeager/bear-mcp-server.git
cd bear-mcp-server/
  1. Install dependencies:```bash
    npm install
3. Build the project:```bash
npm run build
  1. Build binaries:```bash
    /path/to/bear-mcp-server/dist/index.js

## Getting Bear API Token

Some operations require a Bear API token:

**On macOS:**
1. Open Bear App
2. Go to `Help` → `Advanced` → `API Token` → `Copy Token`
3. The token will be copied to your clipboard

## Configuration

Add the server to your MCP client configuration. For Claude Desktop, add to your `claude_desktop_config.json`:```json
{
  "mcpServers": {
    "bear": {
      "command": "node",
      "args": ["/path/to/bear-mcp-server/dist/index.js"],
      "env": {
        "BEAR_TOKEN": "your-bear-api-token-here"
      }
    }
  }
}

Available Tools

Core Note Operations

  • bear_open_note: Open a note by ID or title (returns full note data and metadata)
  • bear_create_note: Create a new note with title, content, and tags (returns note ID and title)
  • bear_add_text: Add text to existing notes (append, prepend, replace)

Search & Discovery

  • bear_search: Search notes by term and/or tag (returns complete search results with metadata)
  • bear_get_tags: Retrieve all available tags (returns full tags array)
  • bear_open_tag: Open notes with specific tag(s) (returns notes list with details)

Organization

  • bear_trash_note: Move notes to trash
  • bear_archive_note: Archive notes
  • bear_get_untagged: Get notes without tags (returns complete untagged notes list)
  • bear_get_todo: Get notes marked as todos (returns todo notes with metadata)
  • bear_get_today: Get today's notes (returns today's notes with details)

Tag Management

  • bear_rename_tag: Rename existing tags
  • bear_delete_tag: Delete tags

Web Integration

  • bear_grab_url: Create notes from web page content (returns created note ID and title)

Security Notes

  • The server uses macOS open command to execute Bear URLs
  • API tokens should be kept secure and not shared
  • Some operations require Bear to be unlocked (not in locked state)
  • Encrypted notes cannot be accessed via the API

Development

Run in development mode:```bash
npm run dev


Build for production:```bash
npm run build

Enhanced Callback Integration

This server leverages Bear's x-success callback mechanism to provide comprehensive data retrieval:

  • Real-time Data: Most operations return actual Bear data instead of generic success messages
  • Complete Results: Search operations return full note arrays with metadata
  • Immediate Access: Created notes return their IDs for follow-up operations
  • Rich Metadata: Notes include titles, identifiers, tags, dates, and content
  • Silent Operation: Auto-closing HTML response minimizes browser window interference
  • Instant Close: Multiple JavaScript methods ensure browser windows close immediately

Callback-Enhanced Tools

The following tools use advanced callback integration for enhanced data retrieval:
- bear_open_note, bear_create_note, bear_search, bear_get_tags
- bear_open_tag, bear_get_untagged, bear_get_todo, bear_get_today, bear_grab_url

Technical Implementation

Auto-Close HTTP Response: Uses standard http://localhost:port/callback URLs but returns HTML with multiple browser-closing mechanisms:
- Immediate window.close() JavaScript execution
- Meta refresh redirect to about:blank
- Hidden body styling to prevent content flash
- Cache-control headers to prevent browser caching

Browser Window Minimization: While a browser window may briefly appear, it closes automatically within milliseconds, providing near-silent operation.

Limitations

  • macOS only (Bear App limitation)
  • Some operations require user interaction with Bear
  • Callback operations have 10-second timeout limit (with automatic fallback)
  • File attachments require base64 encoding
  • Bear must be unlocked for encrypted note access
  • Brief browser window flash may occur (auto-closes within milliseconds)

License

MIT License - feel free to modify and distribute

Contributing

Contributions welcome! Please ensure:
- TypeScript compilation passes (npm run build)
- Bear URL schemes are correctly implemented
- Callback integration works properly
- Error handling is comprehensive
- Documentation is updated
- Test with npm run test (requires Bear App for full functionality)

Links

  • Bear App
  • Bear X-callback-URL Documentation
  • Model Context Protocol

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Bear App MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Bear App MCP Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Bear App MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Bear App MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Bear App MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Bear App MCP Server 能提供哪些能力?

资料显示约 14 个工具;能力标签包括 知识管理、标签管理、JavaScript、Claude、内容生成。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。