Back to Home
bejaminjones icon

bear-notes-mcp

Verified Safe

by bejaminjones

Overview

Provides a Model Context Protocol (MCP) interface for Claude Desktop to interact with Bear notes, enabling comprehensive read and sync-safe write operations.

Installation

Run Command
node /path/to/bear-notes-mcp/dist/index.js

Environment Variables

  • BEAR_DB_PATH
  • LOG_LEVEL
  • NODE_ENV
  • VERBOSE
  • DEBUG
  • BACKUP_DIR
  • ENABLE_BACKUPS
  • MAX_BACKUPS
  • BACKUP_INTERVAL
  • SERVER_NAME
  • SERVER_TIMEOUT
  • MAX_RETRIES
  • BEAR_CHECK_INTERVAL
  • BEAR_MAX_WAIT
  • BEAR_STATUS_CHECK
  • SAFETY_CHECKS
  • ALLOW_DB_WRITES
  • MAX_QUERY_COMPLEXITY
  • CACHE_ENABLED
  • CACHE_TTL
  • MAX_CONCURRENT_QUERIES

Security Notes

The server's design to use direct database reads and Bear's x-callback-url API for writes (hybrid sync-safe mode) is a good practice to prevent database corruption. It leverages 'child_process.exec' for local system commands (AppleScript to check Bear status, 'open' for Bear API calls). While 'exec' can be a security risk if not carefully controlled, its usage here appears confined to specific, documented local interactions with the Bear application. The primary security concern is the requirement for 'Full Disk Access' for Claude Desktop, which the server transparently guides the user through, but is a high-privilege permission.

Similar Servers

Stats

Interest Score40
Security Score8
Cost ClassMedium
Avg Tokens750
Stars16
Forks5
Last Update2025-11-26

Tags

Bear NotesMCPClaude DesktopSQLiteNote ManagementAI Integration