Bear Note Integration

Integrates Claude with the Bear note-taking app on macOS, enabling automated note creation, searching, editing, and tag management through X-Callback-URL.

Quick Start

Prerequisites

1. Bear app installed on macOS
2. API Token (optional, for search/tags features):
   • Help > Advanced > API Token > Copy Token
   • Set environment variable:

     export BEAR_API_TOKEN="your-token"

3. xcall tool (optional, for response handling):
   • Download from xcall releases
   • Install to

     /Applications/xcall.app

Basic Usage

Create a note:

from scripts.bear import create_note

# Create note without response
create_note(title="My Note", text="Content here", tags="work,important")

# Get response with note ID (requires xcall)
result = create_note(title="My Note", text="Content", return_id=True)
print(result['identifier'])

Search notes:

from scripts.bear import search_notes

# Requires xcall and token
results = search_notes(term="project-x", tag="work")
for note in results:
    print(f"{note['title']} - {note['identifier']}")

Core Tasks

1. Create Notes

Create new notes in Bear with optional tags and timestamps.

from scripts.bear import create_note

# Basic note creation
create_note(
    title="Daily Standup",
    text="## Progress\n- Task 1 complete\n- Task 2 in progress",
    tags="work,standup"
)

# With timestamp
create_note(
    title="Meeting Notes",
    text="Key discussion points...",
    tags="meetings",
    add_timestamp=True
)

# With response (returns note ID)
result = create_note(
    title="Important Note",
    text="Critical information",
    return_id=True
)
note_id = result['identifier']

2. Search Notes

Find notes by keywords with optional tag filtering.

from scripts.bear import search_notes

# Keyword search
results = search_notes(term="Python")

# Tag filtering
results = search_notes(term="bug", tag="development")

# Process results
for note in results:
    print(f"Title: {note['title']}")
    print(f"ID: {note['identifier']}")
    print(f"Modified: {note['modificationDate']}")

3. Add Text to Notes

Append or replace text in existing notes.

from scripts.bear import add_text

# Append text
add_text(
    note_id="7E4B681B",
    text="\n\n## Update\nNew content added",
    mode="append"
)

# Append to specific header
add_text(
    note_id="7E4B681B",
    text="- New item",
    mode="append",
    header="TODO"
)

# Replace all content
add_text(
    note_id="7E4B681B",
    text="New complete content",
    mode="replace_all"
)

4. Manage Tags

List, rename, and delete tags.

from scripts.bear import get_tags, rename_tag, delete_tag

# List all tags
tags = get_tags()
for tag in tags:
    print(tag['name'])

# Rename tag
rename_tag(old_name="todo", new_name="inbox")

# Delete tag
delete_tag(name="archive")

5. Capture Web Pages

Save web page content as new Bear notes.

from scripts.bear import grab_url

# Capture URL as note
result = grab_url(
    url="https://example.com/article",
    tags="reference,articles"
)

# With response
result = grab_url(
    url="https://docs.python.org",
    tags="docs",
    return_id=True
)
note_id = result['identifier']

Bundled Resources

scripts/

Python module

bear.py

provides functions for all Bear X-Callback-URL actions:

• create_note()

  - Create notes

• search_notes()

  - Search notes

• add_text()

  - Append/replace text

• open_note()

  - Open notes

• get_tags()

  - List all tags

• rename_tag()

  - Rename tags

• delete_tag()

  - Delete tags

• grab_url()

  - Capture web pages

• trash_note()

  ,

  archive_note()

  - Organize notes

references/

• actions.md: Complete X-Callback-URL API reference with all parameters
• workflows.md: Common workflows and integration patterns
• troubleshooting.md: Setup help and common issues

See these files for detailed API documentation and advanced usage patterns.