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 installUsage
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.jsTools
| 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.sqliteWrite 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
