Labsco
netologist logo

Bear Notes

★ 8

from netologist

Access and manage your notes from the Bear App.

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#database#devops#git#maps#security

Bear App MCP Server

A Model Context Protocol (MCP) server that provides Claude with access to your Bear App notes. Search, retrieve, and analyze your Bear notes directly from Claude Desktop or any MCP-compatible client.

Features

🔍 Search & Discovery

  • Full-text search across all your notes
  • Tag-based filtering for organized content
  • Title-based search with exact or partial matching
  • Recent notes filtering by modification date

💻 Code & Technical Content

  • Kubernetes manifest finder - Locate deployment examples, service configs, etc.
  • Code example search - Find code snippets by programming language
  • Code block extraction - Automatically parse and categorize code blocks
  • Technical documentation discovery

📊 Content Analysis

  • Word count and content statistics
  • Code language detection from fenced code blocks
  • Content previews for quick scanning
  • Metadata extraction (creation/modification dates)

Claude Desktop Integration

Configuration File Location

Edit your Claude Desktop configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json

Add MCP Server Configuration

{
  "mcpServers": {
    "bear-notes": {
      "command": "/full/path/to/mcp-bear-notes/.venv/bin/python",
      "args": ["/full/path/to/mcp-bear-notes/main.py"],
      "env": {
        "PYTHONPATH": "/full/path/to/mcp-bear-notes/.venv/lib/python3.13/site-packages"
      }
    }
  }
}

Important: Replace /full/path/to/ with your actual file paths.

Restart Claude Desktop

Close and reopen Claude Desktop to load the MCP server.

Available Tools

search_bear_notes(query, tag, limit)

Search notes by content and tags.

  • query: Text to search for
  • tag: Filter by specific tag (without #)
  • limit: Max results (default: 20)

get_bear_note(note_id)

Retrieve a specific note by its unique ID.

  • note_id: Bear note's unique identifier

find_kubernetes_examples(resource_type)

Find Kubernetes-related content.

  • resource_type: K8s resource (deployment, service, etc.)

find_code_examples(language, topic, limit)

Search for code examples.

  • language: Programming language
  • topic: Code topic/domain
  • limit: Max results (default: 15)

find_notes_by_title(title_query, exact_match)

Search notes by title.

  • title_query: Title text to search
  • exact_match: Exact or partial matching

get_recent_notes(days, limit)

Get recently modified notes.

  • days: How many days to look back (default: 7)
  • limit: Max results (default: 20)

list_bear_tags()

List all tags found in your notes.

Bear Database Information

The server reads from Bear's SQLite database located at:

~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite

Database Access Notes

  • Read-only access - The server never modifies your notes
  • No authentication required - Uses direct SQLite access
  • Performance - Database queries are optimized for speed
  • Safety - Only accesses non-trashed notes

Security & Privacy

  • Local-only: All data stays on your machine
  • Read-only: Server never modifies your notes
  • No network: No external connections required
  • Open source: Full transparency of operations

Changelog

v1.0.0

  • Initial release
  • Basic search and retrieval functions
  • Kubernetes and code example finders
  • Claude Desktop integration
  • Tag listing and filtering

Support

For issues and questions:

  1. Check the troubleshooting section
  2. Review Claude Desktop MCP documentation
  3. Open an issue on GitHub
  4. Check Bear App forums for database-related questions

Note: This is an unofficial tool and is not affiliated with Bear App or Anthropic. Use at your own discretion.