58CNo CVEsactiveMIT
Quick Install
{
"mcpServers": {
"better-bear": {
"args": [
"-y",
"better-bear"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/better-bear)
Should you use this server?
MCP server and CLI for Bear notes via CloudKit. Includes a context library — a curated, synced folder of notes optimized for LLM consumption, inspired by Karpathy's LLM Knowledge Base pattern.
✓
Is it safe?
No known CVEs for better-bear.
No authentication — any process on your machine can connect.
MIT. View license →
✓
Is it maintained?
Last commit 0 days ago. 51 stars. 1,493 weekly downloads.
i
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
README
better bear
MCP server and CLI for Bear notes via CloudKit. Includes a context library — a curated, synced folder of notes optimized for LLM consumption, inspired by Karpathy's LLM Knowledge Base pattern.
Full docs: better-bear.com
Install
Install the CLI, then connect to Claude:
curl -sL https://raw.githubusercontent.com/KuvopLLC/better-bear/main/install.sh | bash
bcli auth
bcli mcp install
This installs the bcli binary, authenticates with iCloud, and sets up the MCP server for both Claude Desktop (via .mcpb bundle) and Claude Code.
Other install methods
| Method | Command |
|---|---|
| Claude Desktop only | bcli mcp install --desktop-only |
| Claude Code only | bcli mcp install --code-only |
| Claude Code (direct) | claude mcp add better-bear -- npx -y better-bear |
| Config file | bcli mcp install --json |
| .mcpb bundle | Download from latest release and double-click |
Manage
bcli mcp status # check what's configured
bcli mcp uninstall # remove from Claude Desktop and Claude Code
bcli mcp reinstall # clean uninstall + install
bcli upgrade # upgrade bcli binary
CLI
All commands also work standalone from the terminal:
bcli ls # list notes
bcli search "query" # full-text search
bcli create "Title" -b "Body" # create a note
bcli edit <id> --append "text" # append to a note
bcli tags # list all tags
bcli attach <id> photo.jpg # attach a file
bcli stats # library statistics
bcli health # health check
See better-bear.com for the full command reference.
Context Library
Turn a subset of your Bear notes into a synced, curated context folder that Claude can navigate using index-first retrieval. Tag notes with #context in Bear, sync, and Claude reads a compact index to find relevant files — loading only what it needs, not everything.
bcli context init # one-time setup
bcli context sync # pull qualifying notes
bcli context add <id> --subtag research # tag a note for inclusion
bcli context status # health check
Or tell Claude: "Set up a context library" — and it handles everything via MCP tools.
The architecture follows Karpathy's three-folder pattern: bear/ (synced from CloudKit), external/ (PDFs, exports, shared docs), and inbox/ (drop zone for triage). An index.md manifest maps everything. See better-bear.com for full documentation.
MCP Tools
34 tools covering notes, tags, TODOs, attachments, search, front matter, stats, health checks, and the context library. See the [MCP server README](mcp-server/README.
Test This Server
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'better-bear' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Score Breakdown
Security
23/30No known vulnerabilities.
✓
○
Tool safety — No tools to analyze
○
Tool poisoning — No tools to analyze
○
Injection vectors — No tools to analyze
✓
Tool stability — Tool definitions stable
○
Dependency health — found on deps.dev, recently updated
✓
License — License: MIT
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is Better Bear safe to use?
- Better Bear has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
- How do I install Better Bear?
- Better Bear supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
- What AI clients work with Better Bear?
- Better Bear is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.
- Is Better Bear actively maintained?
- Better Bear is actively maintained — last commit was 0 days ago. It has 51 GitHub stars.
Similar servers
View all →
Memory MCP Server
OfficialNo CVEs98A
Persistent memory using a knowledge graph
5 toolsstdio83.8k93.5k/wk1d ago
H
Hash-verified file editing MCP server with token efficiency hook. 11 tools for AI coding agents.
No CVEs95A
Hash-verified file editing MCP server with token efficiency hook. 11 tools for AI coding agents.
5 toolsremote398685.9k/wk11h ago
Context Mode
No CVEs95A
Privacy-first. MCP is the protocol for tool access. We're the virtualization layer for context.
6 toolsremote7.3k10.0k/wk22h ago
Browser Tools Mcp
No CVEs94A
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
7 toolsremote7.2k2.9k/wk28d ago
MCP Security Weekly
Get CVE alerts and security updates for Better Bear and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.