Better Bear vs MCP Local Rag
A side-by-side look at the Better Bear and MCP Local Rag MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Better Bear for knowledge & memory work as a local process; choose MCP Local Rag for knowledge & memory as a local process. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Better Bear when
- You need dedicated capabilities in the Knowledge & Memory domain.
- You prefer a local stdio subprocess transport.
- You want tools like
bear_list_notes, bear_get_note, bear_search.
Choose MCP Local Rag when
- You need dedicated capabilities in the Knowledge & Memory domain.
- You prefer a local stdio subprocess transport.
- Its auth model fits you: No auth required.
- You have the keys it needs:
BASE_DIR, BASE_DIRS, IGNORE_PATHS, DB_PATH, CACHE_DIR, HF_ENDPOINT. - You want tools like
sync_start, sync_status, ingest_file.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Knowledge & Memory | Knowledge & Memory |
| Quality signal | 60/100 · Good | 69/100 · Great |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Local subprocess (stdio) |
| Auth | Not declared | No auth required |
| Pricing | Not declared | Free |
| Required env vars | None listed | BASE_DIRBASE_DIRSIGNORE_PATHSDB_PATHCACHE_DIRHF_ENDPOINT |
| Verified owner | Community listing | Community listing |
| GitHub stars | 68 | 416 |
| Directory activity | 2 views 0 installs 0 upvotes | 13 views 0 installs 0 upvotes |
| Tools | 35 | 9 |
| Full listing | View Better Bear | View MCP Local Rag |
Tools & capabilities
Better Bear tools 35
bear_list_notesList Bear notes with optional tag filtering. Returns an array of notes with IDs, titles, tags, pin status, and modification dates. Each note includes two tag fields: 'tags' mirrors Bear's CloudKit index verbatim (includes ancestor expansions — a note tagged #parent/child will show both 'parent' and 'parent/child'); 'attached_tags' shows only leaf tags (the most-specific tag on each branch). Notes with 'locked: true' are private/encrypted in Bear and their body content is not searchable — if a search returns no results, check whether the relevant note is locked. Use bear_get_note to read the full content of a specific note.bear_get_noteGet a single Bear note's full content and metadata by ID. Returns the note title, tags, full markdown text, and dates. The response includes 'tags' (CloudKit index, may contain ancestor tags like 'parent' for a note tagged '#parent/child') and 'attached_tags' (leaves only). If the note is locked/private, 'locked: true' will be included in the response. Use the 'raw' option to get just the markdown without metadata.bear_searchFull-text search across Bear note titles, tags, and body content. Returns matching notes ranked by relevance (title matches first, then tag, then body). Body matches include a text snippet with surrounding context. Locked/private notes will match by title but may not match body searches — results include 'locked: true' for these notes. If you can't find content you expect, try listing notes to check if the relevant note is locked.bear_get_tagsGet the full tag hierarchy from Bear. Returns all tags with their note counts and pin status. Useful for understanding how notes are organized.bear_create_noteCreate a new Bear note with a title, optional body text, tags, and YAML front matter. Hashtags written inline in the body (e.g. '#my_tag' or '#parent/child') are extracted and registered as real tags on the note, matching Bear's desktop-app behaviour. Tags from the 'tags' array are indexed regardless of whether they appear in the body. Hierarchical tags like '#parent/child' also index every ancestor (so they show up under #parent in Bear's sidebar). Front matter is stored as a collapsed metadata block at the top of the note. Returns the new note's ID.bear_edit_noteEdit an existing Bear note. Provide 'append_text' to add text, 'body' to replace content, or 'set_frontmatter'/'remove_frontmatter' to edit YAML front matter fields. Front matter edits can be combined with each other but not with body/append.bear_trash_noteMove a Bear note to the trash. This is a soft delete — the note can be recovered from Bear's trash. The note is identified by its ID.bear_syncTrigger a sync of Bear notes from iCloud. Normally an incremental sync fetching only changes. Use 'full' to force a complete re-sync. Most read operations auto-sync when the cache is stale, so manual sync is rarely needed.bear_list_todosList Bear notes that have incomplete TODO items (markdown checkboxes like '- [ ]'). Returns each note's title, tags, and counts of complete/incomplete items.bear_get_todosGet all TODO items from a specific Bear note. Returns each item's text, completion status, and index number (use the index with bear_toggle_todo to toggle items).bear_toggle_todoToggle a specific TODO item in a Bear note between complete and incomplete. The item_index is 1-based — use bear_get_todos first to see the list with index numbers.bear_attach_fileAttach a file or image to an existing Bear note. The file is uploaded to iCloud and embedded in the note's markdown. Supports common image formats (jpg, png, gif, webp, heic) and other file types (pdf, zip, etc.). By default the attachment is appended to the end. Use 'after' or 'before' to place it relative to text in the note, or 'prepend' to put it right after the title.- +23 more on the listing page
MCP Local Rag tools 9
sync_startReconcile the index with all configured roots or one pathsync_statusPoll a running sync jobingest_fileIngest or replace one fileingest_dataIngest text, Markdown, or HTML already held by the clientquery_documentsSearch with semantic matching and keyword boostread_chunk_neighborsRead surrounding chunks from a search resultlist_filesShow supported files and their ingestion statedelete_fileDelete an indexed file or an `ingest_data` itemstatusShow index and search status
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Better Bear
{
"mcpServers": {
"better-bear-2": {
"command": "npx",
"args": [
"-y",
"better-bear"
]
}
}
}
MCP Local Rag
{
"mcpServers": {
"shinpr-mcp-local-rag": {
"command": "npx",
"args": [
"-y",
"mcp-local-rag"
],
"env": {
"BASE_DIR": "YOUR_BASE_DIR_HERE",
"BASE_DIRS": "YOUR_BASE_DIRS_HERE",
"IGNORE_PATHS": "YOUR_IGNORE_PATHS_HERE",
"DB_PATH": "YOUR_DB_PATH_HERE",
"CACHE_DIR": "YOUR_CACHE_DIR_HERE",
"HF_ENDPOINT": "YOUR_HF_ENDPOINT_HERE"
}
}
}
}
Frequently asked questions
Better Bear is categorized under Knowledge & Memory and uses a local stdio subprocess. MCP Local Rag belongs to Knowledge & Memory and uses a local stdio subprocess. Pick Better Bear for knowledge & memory work and MCP Local Rag for knowledge & memory.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Better Bear has no declared pricing — check the project's own site. MCP Local Rag is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add better-bear-2 and shinpr-mcp-local-rag as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Better Bear has a quality signal of 60/100 (Good) with 2 views, 0 installs and 68 GitHub stars. MCP Local Rag has 69/100 (Great) with 13 views, 0 installs and 416 GitHub stars.