bear-mcp

An MCP (Model Context Protocol) server that gives Claude and other AI assistants read and write access to your Bear notes on macOS.

Features

• Read notes directly from Bear's SQLite database (no Bear app required to be open for reads)

• Create notes and append/prepend text via Bear's URL scheme

• Search notes by text or tag

• List all tags

• Open notes in the Bear app

Related MCP server: Bear App MCP Server

Requirements

• macOS

• Bear installed

• Node.js 18+

Installation

git clone https://github.com/dineshs99/bear-mcp.git
cd bear-mcp
npm install

Usage

Claude Desktop

Add the server to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bear": {
      "command": "node",
      "args": ["/path/to/bear-mcp/index.js"]
    }
  }
}

Restart Claude Desktop. You should see Bear tools available in the chat input.

Claude Code

claude mcp add bear node /path/to/bear-mcp/index.js

Tools

Example prompts

• "Summarise my Bear notes from the past 7 days"

• "Find all notes tagged #work and give me a bullet-point summary"

• "Create a Bear note titled 'Meeting Notes' with today's date"

• "Append a summary of our conversation to my note titled 'Project Ideas'"

How it works

Read operations query Bear's SQLite database directly at:

~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite

Write operations (create, add text, open) use Bear's x-callback-url API, which requires Bear to be installed and the URL scheme to be available.

License

MIT