akseyh/bear-mcp-server

CategoryGeneral
AuthorCommunity
Stars911
PricingFree

Overview

The bear-mcp-server bridges the gap between LLMs and Bear Notes, providing a standardized interface for AI models to interact with your local macOS knowledge base. Instead of manually copying and pasting notes, this MCP implementation allows the model to query, read, and retrieve specific content directly from your Bear library. For developers building personal productivity workflows or RAG-like systems on macOS, this tool transforms Bear from a static markdown editor into a dynamic context source. It integrates seamlessly with any MCP-compliant host, enabling the AI to reference your private documentation or project notes in real-time without requiring complex API middleware.

Highlights

  • Direct read access to local Bear Notes on macOS
  • Seamless integration with MCP-compliant AI hosts
  • Eliminates manual context copying for personal knowledge management
  • Enables real-time retrieval of private markdown documentation

Full Documentation

Bear MCP Server

![MseeP.ai Security Assessment Badge](https://mseep.ai/app/akseyh-bear-mcp-server)

![Verified on MseeP](https://mseep.ai/app/4ba4aa63-76ae-41d7-9d41-851d9acf7013)

This project is a Model Context Protocol (MCP) server that provides access to the Bear Notes.

Bear stores notes on SQLite database. This MCP server runs some SQL commands to access this notes.
https://bear.app/faq/where-are-bears-notes-located

!Kariyer notu arama örneği

Features

  • Read notes
  • Search notes by text
  • List all tags

Installation

bash
# Clone the project
git clone https://github.com/akseyh/bear-mcp-server

Change directory

cd bear-mcp-server

Install dependencies

npm install

Build the project

npm run build

Claude Desktop Config

Update your claude_desktop_config.json

Docker

json
{
    "mcpServers": {
        "bear": {
            "command": "docker",
            "args": [
                "run",
                "-v",
                "/Users/[YOUR_USER_NAME]/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data:/app/db",
                "-i",
                "akseyh/bear-mcp-server"
            ]
        }
    }
}

NPM

json
{
  "mcpServers": {
    "bear": {
      "command": "npx",
      "args": [
          "bear-mcp-server"
      ]
    }
  }
}

When the server is started, the following MCP tools become available:

  • get_notes: Retrieves all notes
  • get_tags: Lists all tags
  • get_notes_like: Searches for notes containing specific text

Requirements

  • Node.js
  • Bear note application (macOS)
  • Access to Bear database

License

ISC

View official source
Join our Telegram