bear-notes-mcp

Overview

This MCP server provides comprehensive access to Bear notes using a hybrid architecture: direct database reads for performance and Bear's API for sync-safe writes. It offers 26 read operations including search, organization, and content analysis, plus 6 write operations via Bear's x-callback-url API. The server includes robust safety features like conflict detection, tag validation, and iCloud sync compatibility. Built with TypeScript using a service-oriented architecture with 384 comprehensive tests.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_database_stats

  Overview of your Bear database

  Try:What's the status of my notes database?Try:Show me database statistics
• get_notes

  List notes with filtering options

  Try:Show me my recent notesTry:List all notes about projects
• get_note_by_id

  Get specific note by ID

  Try:Retrieve note with ID 12345Try:Show me the note with this identifier
• get_note_by_title

  Find note by exact title

  Try:Find the note titled 'Meeting Notes'Try:Show me the document named 'Project Plan'
• get_tags

  List all tags with usage counts

  Try:What tags do I use most?Try:Show me all my tags and how often they're used
• get_notes_by_tag

  Find notes with specific tag

  Try:Find all notes tagged 'urgent'Try:Show me notes with the 'work' tag
• search_notes_fulltext

  Full-text search with relevance scoring

  Try:Search for notes about API documentationTry:Find mentions of 'client meeting' in my notes
• find_similar_notes

  Content similarity matching

  Try:Find notes similar to my current projectTry:Show me notes with similar content to this one
• get_note_analytics

  Comprehensive note statistics

  Try:Analyze my note-taking patternsTry:Show me statistics about my notes
• create_note

  Create new notes with tags and content

  Try:Create a new note about today's meetingTry:Make a note with tags 'work' and 'urgent'
• update_note

  Update existing notes safely

  Try:Update my project notes with the latest statusTry:Edit the note about the client meeting
• duplicate_note

  Create copies of existing notes

  Try:Duplicate this note with a new titleTry:Make a copy of my meeting notes

Comparable tools

Installation

git clone <repository-url>
cd bear-notes-mcp
npm install
npm run build

{
  "mcpServers": {
    "bear": {
      "command": "node",
      "args": ["/path/to/bear-notes-mcp/dist/index.js"],
      "env": {}
    }
  }
}

FAQ

Is this Bear MCP server safe to use with iCloud sync?

Yes, it uses a hybrid approach: direct database reads (safe) and Bear API for writes (sync-safe). All write operations use Bear's official x-callback-url API to prevent iCloud conflicts.

What are the system requirements?

Requires Bear app installed on macOS, Claude Desktop app, and Node.js 18+. The server automatically locates your Bear database at '~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite'.

Compare bear-notes-mcp with