playbooks

home / mcp / bear mcp server

Bear MCP Server

Provides read-only access to Bear notes via MCP, enabling note search, open, and tag queries for AI assistants.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "bart6114-my-bear-mcp-server": {
      "command": "npx",
      "args": [
        "github:bart6114/my-bear-mcp-server"
      ]
    }
  }
}

This Bear MCP Server lets your AI assistants read notes from the Bear app by connecting to Bear’s SQLite database in a strictly read-only mode. It enables convenient, safe access to your notes for search, open, and tag-related queries without risking any modification to your data.

How to use

Use this MCP server with your preferred MCP client to let your AI assistant fetch notes, search across notes and tags, and open specific notes. The server is read-only, so it retrieves data without making any changes. You can open a note by title or ID, search for notes by term or tag, get all tags, and show notes that share a specific tag.

How to install

Prerequisites: macOS with the Bear app installed and Node.js 18 or higher.

Install from GitHub (Recommended)

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

Clone and run locally

Clone the repository, install dependencies, build, then start the server.

# 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

Advanced options

If your Bear database is in a non-standard location, you can specify the path to the database file when starting the server.

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

Available tools

open_note

Open a note by title or ID.

search_notes

Search notes by term or tag.

get_tags

Retrieve all tags from Bear.

open_tag

Show all notes with a specific tag.