# KuvopLLC/better-bear

Source: https://glimind.com/server/awesome%2Fkuvopllc%2Fbetter-bear
Registry id: `awesome/kuvopllc/better-bear`
Status: unknown

## Tools (33)

- `bear_add_tag`: Add a tag to an existing Bear note. The tag is inserted into the note's markdown. Hierarchical tags like 'parent/child' also index every ancestor — so the note 
- `bear_archive_note`: Archive a Bear note. Archived notes are hidden from the main list but not deleted. Use 'undo' to unarchive.
- `bear_attach_file`: Attach 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, gi
- `bear_context_add`: Add a Bear note to the context library by tagging it with #context. Optionally specify a subtag for grouping (e.g., subtag 'jira' → #context/jira). Triggers a s
- `bear_context_fetch`: Load the full content of specific files from the context library. Pass relative paths like 'bear/arch-overview.md' or 'external/jira-ticket.md'. Use after readi
- `bear_context_import`: Import external content into the context library. Content is written to the external/ directory with YAML front matter (source, group, summary, date). Use this 
- `bear_context_index`: Get the context library index — a structured table of contents of all files (Bear notes, external files, inbox). Read this FIRST before answering questions from
- `bear_context_ingest`: Scan the inbox/ directory and list all untriaged files. Returns filename, size, content preview (first 500 chars), and any detected YAML front matter for each f
- `bear_context_push_to_bear`: Push an external file to Bear as a new note. Creates a Bear note from the file content, tags it with #context (+ optional subtag), and removes the original exte
- `bear_context_remove`: Remove a Bear note from the context library by removing its #context tag. Triggers a sync to delete the local file.
- `bear_context_remove_external`: Remove a file from the external/ directory in the context library. Deletes the file and regenerates the index. Use when external content is no longer needed.
- `bear_context_search`: Full-text search across the entire context library (Bear notes + external files + inbox). Returns matching snippets with filenames and origin labels. Use when t
- `bear_context_set_prefix`: Change the context library's tag prefix and re-tag every Bear note that currently uses the old prefix. Sub-tags are preserved — `#context/research` becomes `#<n
- `bear_context_setup`: Initialize a context library — a curated, synced folder of Bear notes optimized for LLM consumption. Creates the directory structure and config. After setup, ta
- `bear_context_status`: Get context library health and stats: Bear note count, external file count, inbox count, total tokens, last sync time, group breakdown, and warnings (stale cach
- `bear_context_sync`: Sync qualifying Bear notes to the local context library. Adds new notes, updates changed notes, and removes notes that no longer qualify (tag removed, trashed, 
- `bear_context_triage`: Triage a file in the inbox. Three actions: 'keep' moves it to external/ with optional group/summary metadata. 'push_to_bear' creates a Bear note tagged #context
- `bear_delete_tag`: Delete a tag from all Bear notes. The tag text is removed but notes are preserved.
- `bear_edit_note`: Edit an existing Bear note. Provide 'append_text' to add text, 'body' to replace content, or 'set_frontmatter'/'remove_frontmatter' to edit YAML front matter fi
- `bear_find_duplicates`: Find notes with duplicate titles. Returns groups of notes sharing the same title with their IDs and modification dates. Useful for cleaning up after imports or 
- `bear_find_untagged`: List Bear notes that have no tags assigned.
- `bear_get_note`: Get 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 in
- `bear_get_tags`: Get the full tag hierarchy from Bear. Returns all tags with their note counts and pin status. Useful for understanding how notes are organized.
- `bear_get_todos`: Get 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_health_check`: Run a health check on the Bear notes library. Reports duplicate titles, empty notes, notes stuck in trash, sync conflicts, orphaned tags, untagged notes, and ov
- `bear_list_todos`: List Bear notes that have incomplete TODO items (markdown checkboxes like '- [ ]'). Returns each note's title, tags, and counts of complete/incomplete items.
- `bear_note_stats`: Get statistics about the Bear notes library: total notes, words, tags, pinned, archived, trashed, notes with TODOs, oldest/newest dates, and top 10 tags by note
- `bear_remove_tag`: Remove a tag from a specific Bear note. Works on any tag visible in 'tags' on the note — including ancestor tags like 'parent' that exist only as hierarchical e
- `bear_rename_tag`: Rename a tag across all Bear notes. Every note containing the old tag will be updated.
- `bear_search`: Full-text search across Bear note titles, tags, and body content. Returns matching notes ranked by relevance (title matches first, then tag, then body). Body ma
- `bear_sync`: Trigger 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-
- `bear_toggle_todo`: Toggle 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 numb
- `bear_trash_note`: Move 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.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.