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

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

Tool	Description
get_recent_notes	Get notes created or modified in the past N days
search_notes	Search notes by text query and/or tag
get_note	Fetch the full content of a note by ID or title
get_all_tags	List all tags in your Bear library
get_notes_by_tag	Get all notes with a specific tag
create_note	Create a new note (opens in Bear)
add_text_to_note	Append, prepend, or replace text in a note
open_note	Open a specific note in the Bear app

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