Bear MCP Server
A Model Context Protocol (MCP) server that allows AI assistants like Claude to read notes from the [Bear](https://bear.app/) note-taking app. This implementation connects directly to the Bear SQLite database in a read-only mode, ensuring your notes remain safe and unmodified.
[](https://github.com/bart6114/my-bear-mcp-server)
[](https://bear.app)
[](https://claude.ai)
[](https://www.typescriptlang.org/)
[](https://opensource.org/licenses/MIT)
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
All operations performed by this server are SELECT queries that only retrieve data without modifying it.
License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.