Bear MCP Server

1# Bear MCP Server
2 
3A 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.
4 
5[![Read-Only](https://img.shields.io/badge/Mode-Read%20Only-brightgreen.svg)](https://github.com/bart6114/my-bear-mcp-server)
6[![Bear App](https://img.shields.io/badge/For-Bear%20App-blue.svg)](https://bear.app)
7[![Works with Claude](https://img.shields.io/badge/Works%20with-Claude%20AI-blueviolet.svg)](https://claude.ai)
8[![TypeScript](https://img.shields.io/badge/Made%20with-TypeScript-007ACC.svg)](https://www.typescriptlang.org/)
9[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
10 
11## Quick Start
12 
13### Option 1: Install from GitHub (Recommended)
14 
15```bash
16npx github:bart6114/my-bear-mcp-server
17```
18 
19That's it! The server will start running and connect to your Bear database.
20 
21### Option 2: Clone and Run Locally
22 
23```bash
24# Clone the repository
25git clone https://github.com/bart6114/my-bear-mcp-server.git
26cd my-bear-mcp-server
27 
28# Install dependencies
29npm install
30 
31# Build and run
32npm run build
33npm start
34```
35 
36## Prerequisites
37 
38- macOS with Bear app installed
39- Node.js 18 or higher
40 
41## Configuration
42 
43### For Claude Desktop App
44 
45Add this to your configuration file at `~/Library/Application Support/Claude/claude_desktop_config.json`:
46 
47```json
48{
49  "mcpServers": {
50    "bear": {
51      "command": "npx",
52      "args": ["github:bart6114/my-bear-mcp-server"],
53      "env": {},
54      "disabled": false,
55      "autoApprove": []
56    }
57  }
58}
59```
60 
61### For Claude VS Code Extension
62 
63Add this to your configuration file at `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`:
64 
65```json
66{
67  "mcpServers": {
68    "bear": {
69      "command": "npx",
70      "args": ["github:bart6114/my-bear-mcp-server"],
71      "env": {},
72      "disabled": false,
73      "autoApprove": []
74    }
75  }
76}
77```
78 
79## Available Tools
80 
81The Bear MCP server provides these read-only tools (all operations are non-destructive and cannot modify your Bear database):
82 
83### open_note
84 
85Open a note by title or ID.
86 
87### search_notes
88 
89Search for notes by term or tag.
90 
91### get_tags
92 
93Get all tags in Bear.
94 
95### open_tag
96 
97Show all notes with a specific tag.
98 
99## Example Usage
100 
101Here are examples of how to interact with the Bear MCP tools through AI assistants:
102 
103### Searching for Notes
104 
105Ask your AI assistant to search for notes containing specific terms:
106 
107```
108Can you find all my notes about "project management"?
109```
110 
111### Opening a Specific Note
112 
113Ask your AI assistant to retrieve a specific note by title:
114 
115```
116Show me my note titled "Meeting Notes - March 2025"
117```
118 
119### Viewing Tags
120 
121Ask your AI assistant to list all your Bear tags:
122 
123```
124What tags do I have in my Bear notes?
125```
126 
127### Finding Notes with a Specific Tag
128 
129Ask your AI assistant to show notes with a particular tag:
130 
131```
132Show me all notes with the #work tag
133```
134 
135## Advanced Options
136 
137If your Bear database is in a non-standard location:
138 
139```bash
140npx github:bart6114/my-bear-mcp-server --db-path /path/to/your/database.sqlite
141```
142 
143## Technical Details
144 
145### Read-Only Implementation
146 
147This MCP server connects to your Bear SQLite database using a strict read-only connection. This is enforced at the database driver level:
148 
149```typescript
150// From src/bear-db.ts
151this.db = new Database(dbPath, { readonly: true });
152```
153 
154This ensures that:
155- No write operations can be performed on your database
156- Your notes and tags cannot be modified, deleted, or corrupted
157- The database connection will fail if write permissions are attempted
158 
159All operations performed by this server are SELECT queries that only retrieve data without modifying it.
160 
161## License
162 
163This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
164