Bear MCP Server

MIT License
2
  • Apple

Integrations

  • Requires macOS with Bear app installed for the MCP server to function properly by connecting to the Bear SQLite database.

  • Connects to the Bear SQLite database in read-only mode to safely retrieve note data without modifying the underlying database.

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

npx github:bart6114/my-bear-mcp-server

That's it! The server will start running and connect to your Bear database.

Option 2: Clone and Run Locally

# 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

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:

{ "mcpServers": { "bear": { "command": "npx", "args": ["github:bart6114/my-bear-mcp-server"], "env": {}, "disabled": false, "autoApprove": [] } } }

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:

{ "mcpServers": { "bear": { "command": "npx", "args": ["github:bart6114/my-bear-mcp-server"], "env": {}, "disabled": false, "autoApprove": [] } } }

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:

Can you find all my notes about "project management"?

Opening a Specific Note

Ask your AI assistant to retrieve a specific note by title:

Show me my note titled "Meeting Notes - March 2025"

Viewing Tags

Ask your AI assistant to list all your Bear tags:

What tags do I have in my Bear notes?

Finding Notes with a Specific Tag

Ask your AI assistant to show notes with a particular tag:

Show me all notes with the #work tag

Advanced Options

If your Bear database is in a non-standard location:

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

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:

// From src/bear-db.ts this.db = new Database(dbPath, { readonly: true });

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 file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that allows AI assistants like Claude to read notes from the Bear note-taking app in a safe, read-only mode.

  1. Quick Start
    1. Option 1: Install from GitHub (Recommended)
    2. Option 2: Clone and Run Locally
  2. Prerequisites
    1. Configuration
      1. For Claude Desktop App
      2. For Claude VS Code Extension
    2. Available Tools
      1. open_note
      2. search_notes
      3. get_tags
      4. open_tag
    3. Example Usage
      1. Searching for Notes
      2. Opening a Specific Note
      3. Viewing Tags
      4. Finding Notes with a Specific Tag
    4. Advanced Options
      1. Technical Details
        1. Read-Only Implementation
      2. License

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that enables semantic search and RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.
          Last updated -
          6
          TypeScript
          • Apple
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.
          Last updated -
          12
          309
          14
          TypeScript
          MIT License
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
          Last updated -
          598
          TypeScript
          ISC License
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
          Last updated -
          25
          1
          Python
          MIT License

        View all related MCP servers

        ID: q04mrxtyp0