my-bear

The Bear MCP Server is a read-only MCP service that lets Claude and other AI assistants query your Bear notes directly from the Bear SQLite database without modifying any data. It exposes a set of read-only tools that retrieve notes, lists of tags, and tag-based groupings, enabling natural language interactions like searching for notes, opening specific notes by title or ID, and exploring tags. The server runs via npx using the GitHub-hosted package bart6114/my-bear-mcp-server, so you don’t need to install Bear or run servers locally beyond your existing Node.js environment. Use the provided tools to fetch data and present results to users in a structured, non-destructive way.

Available tools include:

• open_note: Retrieve a note by title or ID.
• search_notes: Find notes matching a term or tag.
• get_tags: List all tags in Bear.
• open_tag: Show all notes assigned to a specific tag. These tools are strictly read-only, ensuring your Bear database remains intact while conversations extract information for display or processing by the AI assistant.

Prerequisites

• macOS with Bear app installed (or access to your Bear database location)
• Node.js 18 or higher

Installation steps

1. Install and run the MCP server via npx (as recommended): npx github:bart6114/my-bear-mcp-server

2. If you prefer to clone locally, install dependencies and run:

# Clone the repository
git clone https://github.com/bart6114/my-bear-mcp-server.git
cd my-bear-mcp-server

# Install dependencies
npm install

# Build and run
npm run build
npm start

3. Optional: point the server to a non-standard Bear database location (non-default Bear DB path):

npx github:bart6114/my-bear-mcp-server --db-path /path/to/your/database.sqlite

Prerequisites recap: ensure Bear is installed and that Node.js (v18+) is available on the system.

Tips and considerations:

• The server connects to Bear in read-only mode to prevent any data modification. Attempts to write will fail at the driver level.
• If you use a custom Bear database location, pass the --db-path option to point to your database.sqlite file.
• The npx approach downloads and runs the server on demand; for longer-running deployments, you may prefer a persistent setup (e.g., local deployment via npm start).
• When integrating with Claude or other assistants, configure the MCP in the appropriate settings file with the nthixn: a Bear MCP entry using command npx and the github:bart6114/my-bear-mcp-server reference.
• If you encounter issues, ensure the Bear database path is readable by the process and that there are no permission restrictions preventing access to the SQLite file.