bart6114/my-bear-mcp-server

A Model Context Protocol (MCP) server that allows AI assistants like Claude to read notes from the Bear note-taking app. This implementation connects directly to the Bear SQLite database in a read-only mode, ensuring your notes remain safe and unmodified.
Quick Start
Option 1: Install from GitHub (Recommended)
That's it! The server will start running and connect to your Bear database.
Option 2: Clone and Run Locally
Prerequisites
- macOS with Bear app installed
- Node.js 18 or higher
Configuration
For Claude Desktop App
Add this to your configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:
For Claude VS Code Extension
Add this to your configuration file at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
Available Tools
The Bear MCP server provides these read-only tools (all operations are non-destructive and cannot modify your Bear database):
open_note
Open a note by title or ID.
search_notes
Search for notes by term or tag.
get_tags
Get all tags in Bear.
open_tag
Show all notes with a specific tag.
Example Usage
Here are examples of how to interact with the Bear MCP tools through AI assistants:
Searching for Notes
Ask your AI assistant to search for notes containing specific terms:
Opening a Specific Note
Ask your AI assistant to retrieve a specific note by title:
Viewing Tags
Ask your AI assistant to list all your Bear tags:
Finding Notes with a Specific Tag
Ask your AI assistant to show notes with a particular tag:
Advanced Options
If your Bear database is in a non-standard location:
Technical Details
Read-Only Implementation
This MCP server connects to your Bear SQLite database using a strict read-only connection. This is enforced at the database driver level:
This ensures that:
- No write operations can be performed on your database
- Your notes and tags cannot be modified, deleted, or corrupted
- The database connection will fail if write permissions are attempted