Skip to main content
Glama
ntwkrgr

bear-mcp

by ntwkrgr
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

bear-mcp

An MCP server that gives Claude direct access to your Bear notes via better-bear-cli (bcli).

bcli talks to Bear through CloudKit (the same path Bear Web uses), so it's safe to run alongside Bear without touching the local SQLite database.

Prerequisites

  1. better-bear-cli installed and authenticated:

    brew install bcli   # or however you install it
bcli auth           # authenticate with Bear / iCloud

  2. Node.js 18+

Related MCP server: Bear MCP Server

Setup

cd /path/to/bear-mcp
npm install
npm run build

Then register in ~/.claude.json under the project you want bear-mcp available in:

{
  "mcpServers": {
    "bear-mcp": {
      "command": "node",
      "args": ["/Users/you/Developer/MCP Servers/bear-mcp/dist/index.js"]
    }
  }
}

Available Tools

Tool

Description

bear_list_notes

List notes, optionally filtered by tag or including archived/trashed

bear_get_note

Get the full content of a note by ID

bear_list_tags

List all tags across your notes

bear_search_notes

Full-text search across notes

bear_create_note

Create a new note with title, body, and tags

bear_edit_note

Append text to an existing note

bear_trash_note

Move a note to trash

bear_export_notes

Export notes as Markdown files to a directory

Environment Variables

Variable

Default

Purpose

BEAR_BCLI_PATH

PATH lookup

Override path to the bcli binary

BEAR_MCP_LOG

off

Set to debug to enable stderr logging

Development

npm run dev    # TypeScript watch mode
npm run build  # Compile to dist/
npm start      # Run compiled server

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Bear MCP Server

    jkawamoto
    A
    license
    Not graded
    quality
    F
    maintenance
    Facilitates interaction with Bear note-taking software, allowing users to perform actions like opening notes, creating notes, and searching through Bear's X-callback-url Scheme.
    77
    MIT

  • Bear MCP Server

    quanticsoul4772
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search, read, and browse Bear notes directly from your local Bear database. Supports searching by title, content, or tags, opening specific notes, and exploring tag-based organization.
    1
    -

  • Bear MCP Server

    binnapro
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude Code to interact with Bear notes on macOS, supporting create, search, update, delete, open notes, and tag management via natural language.
    8 npm
    ISC