bear-mcp

MCP server for the Bear note-taking app on macOS. Lets Claude read, search, create, and manage your Bear notes.

Architecture: Reads from Bear's SQLite database directly (fast, no UI interruption). Writes through Bear's x-callback-url scheme (safe for iCloud sync). No API token required.

Requirements

• macOS with Bear installed (tested with v2.6.7)

• Bun runtime

Related MCP server: Bear Notes MCP Server

Setup

git clone https://github.com/lukewilson/bear-mcp.git
cd bear-mcp
bun install

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "bear": {
      "command": "bun",
      "args": ["run", "/path/to/bear-mcp/src/index.ts"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bear": {
      "command": "bun",
      "args": ["run", "/path/to/bear-mcp/src/index.ts"]
    }
  }
}

Tools

Development

bun run dev          # Run with hot reload
bun run inspect      # Open MCP Inspector
bun run typecheck    # Type check