mcp-bear

# MCP Bear A Python-based Model Context Protocol (MCP) server that provides access to [Bear Notes](https://bear.app). Bear stores notes in a SQLite database. This MCP server provides both read and write access to your notes. See: https://bear.app/faq/where-are-bears-notes-located ## Features ### Read Operations - Read all notes (active and archived) from Bear's SQLite database - Search notes by text content, tag, or unique ID - List all tags - Get notes by specific tag - Get archived notes separately ### Note Management - Create new notes with title, content, and tags - Append, prepend, or replace text in existing notes - Archive/unarchive notes for organization - Move notes to trash ### Tag Management - Add tags to existing notes - Rename tags across all notes - Open Bear showing notes with specific tag ### Bear Integration - Open specific notes in Bear - Search within Bear app - All operations integrate seamlessly with Bear's UI Write operations use Bear's official [x-callback-url API](https://bear.app/faq/x-callback-url-scheme-documentation/) for safe, reliable modifications. ## Requirements - Python 3.10 or higher (tested with 3.14) - Bear note application (macOS) - Access to Bear database ## Installation ### Development Setup ```bash # Clone the repository git clone https://github.com/maxim-ist/mcp-bear.git cd mcp-bear # Install dependencies (using mise for Python version management) mise install mise exec -- python -m venv .venv .venv/bin/pip install -e . ``` ### Install via pip (when published) ```bash pip install mcp-bear ``` ## Claude Desktop Configuration Add this to your `claude_desktop_config.json`: ### Using Python directly ```json { "mcpServers": { "bear": { "command": "python", "args": [ "-m", "mcp_bear.server" ], "env": { "PYTHONPATH": "/Users/YOUR_USERNAME/Work/mcp-bear/src" } } } } ``` ### Using installed package ```json { "mcpServers": { "bear": { …