{"id":"bejaminjones-bear-notes-mcp","name":"bear-notes-mcp","homepage":null,"repo_url":"https://github.com/bejaminjones/bear-notes-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","bear","notes","knowledge-management","sqlite","productivity","claude-desktop","typeScript"],"what_it_does":"Provides an MCP server for Claude Desktop to read Bear note data directly from Bear’s SQLite database (read-only) and to write changes via Bear’s x-callback-url API (sync-safe) on macOS.","use_cases":["Search and retrieve Bear notes (by title, tag, full-text, or advanced criteria)","Generate note analytics/insights (tags, relationships, metadata/attachments)","Assist with note organization tasks (create/update/archive, tagging/hashtag parsing)","Support knowledge-work workflows by letting an AI agent browse and modify a user’s Bear notes"],"not_for":["Cross-platform use (appears macOS/Bear-specific)","Use in environments where local database access is not allowed","Highly regulated scenarios without a review of data flows (local DB reads + app API writes)","Using as a public multi-tenant service (no mention of hosted/authenticated deployment)"],"best_when":"You run Claude Desktop on macOS with Bear installed, and you want an AI assistant to safely manage your own personal note library with fast local reads and sync-safe writes.","avoid_when":"You need a hosted SaaS integration with strong, centralized auth; or you cannot grant the executing process file-system access to the Bear database file.","alternatives":["Other MCP servers/integrations for note apps that use official APIs for both read/write (if available)","Building a custom integration that uses Bear’s x-callback-url API for reads as well (if supported)","Using Bear’s own search/export capabilities and building an offline RAG index separately"],"af_score":63.8,"security_score":29.5,"reliability_score":23.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:27:42.389875+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["None documented (local MCP server execution)"],"oauth":false,"scopes":false,"notes":"The README shows local execution via Claude Desktop MCP config; no user auth scheme is described. Authorization is effectively via local machine access and Bear app/x-callback-url behavior."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source MIT license; no hosted pricing described."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":63.8,"security_score":29.5,"reliability_score":23.8,"mcp_server_quality":88.0,"documentation_accuracy":70.0,"error_message_quality":null,"error_message_notes":"README mentions robust error management and specific troubleshooting strings (e.g., 'Database not found', 'Permission denied', 'Write operations not working'), but does not document structured MCP error codes or payload schemas.","auth_complexity":95.0,"rate_limit_clarity":5.0,"tls_enforcement":20.0,"auth_strength":25.0,"scope_granularity":10.0,"dependency_hygiene":55.0,"secret_handling":45.0,"security_notes":"Security posture is mainly local: MCP server runs on the user machine and accesses a local SQLite DB and triggers Bear app actions via x-callback-url. There is no TLS/auth described because it is not a networked service per README. Main risks inferred from README: local file access permissions, potential exposure of note content to the MCP host process/logging, and lack of documented structured audit/redaction controls. Dependency list includes common libraries (sqlite3, winston, zod, dotenv) but no vulnerability/SBOM/CVE status is provided.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":0.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are described for write operations (create/update/batch hashtag parsing). Some operations like updates may be repeatable but behavior on retries is not specified.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Write operations depend on Bear and its x-callback-url functionality; if Bear hasn’t been opened at least once, writes may fail.","Database path assumptions on macOS; users may need BEAR_DB_PATH override.","Large databases may cause slower reads; unconstrained queries can be slow.","Tag sanitization auto-corrects formats and may return warnings; agents should expect canonicalized tags instead of echoing inputs verbatim.","Concurrent writes/updates may be impacted by Bear-side conflict detection; retry behavior is not documented."]}}