เซิร์ฟเวอร์ MCP Bear Notes | PlugMCP
ข้ามไปยังเนื้อหา ไดเรกทอรี ผลิตภัณฑ์ แหล่งข้อมูล Pricing
เอกสารประกอบ Bear MCP Server
A Model Context Protocol (MCP) server that provides Claude with comprehensive access to your Bear notes using a hybrid sync-safe approach - combining direct database reads with Bear's API for writes.
🔄 Sync-Safe Hybrid Mode : All operations now work safely with iCloud sync!
⚠️
MCP server for Bear app - Full Read + Write AI-powered note management with Claude Desktop
เสียบเครื่องมือใดก็ได้เข้ากับเอเจนต์ใดก็ได้ ไดเรกทอรี MCP สำหรับคนที่ไม่เขียนเซิร์ฟเวอร์
ผลิตภัณฑ์
ไดเรกทอรี
นักพัฒนา
บริษัท
Disclaimer
This tool uses a hybrid approach: direct database reads + Bear API writes. While comprehensive safety measures are implemented:
Read operations access Bear's database directly (read-only, safe)
Write operations use Bear's official API (sync-safe)
The tool is not affiliated with Bear's developers
Always maintain regular Bear backups as good practice
🚀 Quick Start (5 minutes)
Prerequisites
Bear app installed on macOS
Claude Desktop app
Node.js 18+ installed
Installation git clone <repository-url>
cd bear-notes-mcp
npm install
npm run build
Add to Claude Desktop configuration:
Edit ~/Library/Application Support/Claude/claude_desktop_config.json: {
"mcpServers": {
"bear": {
"command": "node",
"args": ["/path/to/bear-notes-mcp/dist/index.js"],
"env": {}
}
}
}
Restart Claude Desktop
Ask Claude: "What Bear notes do I have?"
Begin managing your notes with natural language!
✨ What You Can Do
📖 Read Operations (26 tools) - ✅ ACTIVE
Search & Discovery : Full-text search, find similar notes, get suggestionsOrganization : Browse by tags, analyze note relationships, get statisticsContent Analysis : Extract metadata, analyze attachments, find patternsAdvanced Queries : Complex filtering, date ranges, content criteria
✏️ Write Operations (6 tools) - ✅ ACTIVE (Sync-Safe)
Create Notes : ✅ Via Bear API (sync-safe)Edit Notes : ✅ Via Bear API (sync-safe)Organize : ✅ Via Bear API (sync-safe)Tag Management : ✅ Via Bear API (sync-safe)Hashtag Parsing : ✅ Via Bear API (sync-safe)
How it works : Uses Bear's x-callback-url API for writes, database for reads!
🛡️ Safety Features
Hybrid Architecture : Database reads + API writes for maximum safetyiCloud Sync Safe : All write operations use Bear's APIConflict Detection : Prevents overwriting concurrent changesTag Validation : Automatic tag sanitization with warningsError Handling : Robust error management for all operations
📊 Capabilities Overview
🔧 Configuration
Database Location The server automatically finds your Bear database at:
~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite
Environment Variables
BEAR_DB_PATH: Override default database location (for reads)NODE_ENV: Set to 'development' for debug logging
📚 Usage Examples
Basic Note Management "Show me my recent notes"
"Find all notes tagged with 'project'"
"Create a new note about today's meeting"
"Search for notes containing 'API documentation'"
"Update my project notes with the latest status"
Advanced Operations "Analyze my note-taking patterns this month"
"Find notes similar to my current project"
"Show me notes with attachments"
"What are my most-used tags?"
Organization & Cleanup "Archive old notes from last year"
"Find duplicate or similar notes"
"Show me notes that might need better tags"
"Duplicate this note with a new title"
"Add tags to organize my notes better"
🛡️ Safety & Best Practices
⚠️ Safety Guidelines
Bear can run during operations - Write operations use Bear's API safelyAutomatic tag validation - Tags are sanitized with warningsiCloud sync compatible - No conflicts or sync issuesKeep Bear updated - Ensure API compatibility
💡 Best Practices
Read operations are instant - direct database accessWrite operations work with Bear running or closedTag warnings show when tags are auto-correctedUse specific search terms for better results
Archive notes instead of deleting when possible
🏷️ Tag Formatting Guidelines ✅ RECOMMENDED TAG FORMATS:
Simple tags: work, personal, urgent, meeting
Nested categories: work/projects, personal/health, study/math
Time-based: 2024, january, q1
Project codes: proj001, alpha, beta
❌ AVOID THESE FORMATS (auto-corrected):
Hyphens : project-alpha → becomes projectalphaSpaces : work meeting → becomes workmeetingMixed case : ProjectAlpha → becomes projectalpha 🔧 Automatic Tag Sanitization:
The server automatically validates and sanitizes all tags:
Lowercase only : Project → projectNo spaces : tag name → tagnameNo hyphens : project-alpha → projectalphaNo commas : tag,name → tagname✅ Forward slashes preserved : project/alpha → project/alpha (for nested tags) Tag warnings are returned when tags are modified, so you'll know exactly what changes were made.
🏗️ REFACTORED SERVICE ARCHITECTURE ✅ Completely refactored from monolith to modern service-oriented architecture!
Transformation Overview We've completely rebuilt the system from a 2,589-line monolithic BearService into a modern, testable, service-oriented architecture :
7 specialized services with clear responsibilitiesDependency injection for testability and flexibilityInterface-driven development for maintainability384 comprehensive tests across all services 🛡️ Hybrid Sync-Safe Architecture
Read Operations : Direct SQLite database access for maximum performanceWrite Operations : Bear's x-callback-url API for sync safetyPerfect coordination using ZUNIQUEIDENTIFIER bridge
100% TypeScript with strict type checkingComprehensive error handling and validationMulti-level caching for performance optimizationStructured logging and health monitoring
Service Architecture ServiceContainer (Dependency Injection)
├── DatabaseService (SQLite operations & connection management)
├── CacheService (Performance optimization & intelligent caching)
├── LoggingService (Structured logging with Winston)
├── HealthService (System monitoring & health checks)
├── ValidationService (Input validation & data sanitization)
├── NoteService (Note CRUD & lifecycle management)
├── SearchService (Advanced search & content discovery)
└── TagService (Tag management & organization)
Why This Architecture Works The Problem : Monolithic code was hard to test, maintain, and extend.
The Solution : Service-oriented architecture with clear separation of concerns.
✅ Maintainable code - Clear service boundaries and responsibilities
✅ 100% test coverage - 384 tests across all services
✅ Type safety - Eliminated 50+ any types
✅ Performance optimized - Multi-level caching and query optimization
✅ Production ready - Comprehensive logging, monitoring, and error handling
✅ Sync-safe operations - Hybrid approach eliminates iCloud conflicts
Current Status
✅ All read operations - Direct database access (26 tools)
✅ All write operations - Sync-safe Bear API (6 tools)
✅ Full feature parity - Everything works as designed
✅ iCloud sync compatible - No conflicts or issues
✅ Duplicate title fix - Notes display titles correctly (no duplication)
🙏 Thanks to Bear Team Special thanks to Danilo from the Bear team who provided the key insight that led to this solution!
🤝 Contributing & Community The iCloud sync challenge has been solved! 🎉 Now we're focused on making this the best Bear integration possible. Whether you're a:
macOS/iOS developer with API experienceDatabase expert familiar with SQLite optimizationBear power user with workflow insightsDeveloper wanting to contribute to MCP ecosystem Your contribution can help thousands of Bear users get even more from their AI assistants!
Current Priorities
🚀 Add new features - More ways to analyze and work with notes
📖 Improve documentation - Help others understand and contribute
🧪 Expand test coverage - Ensure reliability across Bear versions
⚡ Performance optimization - Make operations even faster
Quick Ways to Help
⭐ Star the repo if you find it useful
🐛 Report issues you encounter
💡 Share ideas for new features or solutions
🔗 Spread the word to developers who might help
📝 Contribute documentation improvements
Together, we can build the most powerful Bear integration for AI assistants!
🔍 All Available Tools
Basic Operations (6 tools)
get_database_stats - Overview of your Bear databaseget_notes - List notes with filtering optionsget_note_by_id - Get specific note by IDget_note_by_title - Find note by exact titleget_tags - List all tags with usage countsget_notes_by_tag - Find notes with specific tag
Advanced Search (8 tools)
get_notes_advanced - Complex filtering and sortingget_notes_with_criteria - Multi-criteria searchsearch_notes_fulltext - Full-text search with relevance scoringget_search_suggestions - Auto-complete for searchesfind_similar_notes - Content similarity matchingget_related_notes - Find related notes by tags and contentget_recent_notes - Recently created or modified notesget_note_counts_by_status - Statistics by note status
Analytics & Insights (6 tools)
get_note_analytics - Comprehensive note statisticsanalyze_note_metadata - Content pattern analysisget_notes_with_metadata - Filter by content characteristicsget_file_attachments - File attachment managementget_tag_hierarchy - Tag relationship analysisget_tag_analytics - Tag usage patterns
Content Analysis (6 tools)
analyze_tag_relationships - Tag optimization suggestionsget_tag_usage_trends - Tag usage over timesearch_notes_regex - Pattern matching (when available)Advanced content categorization
Link and reference analysis
Writing pattern insights
Note Management - SYNC-SAFE VIA BEAR API
create_note - ✅ Create new notes with tags and contentupdate_note - ✅ Update existing notes safelyduplicate_note - ✅ Create copies of existing notesarchive_note - ✅ Archive/unarchive notestrigger_hashtag_parsing - ✅ Force hashtag reprocessingbatch_trigger_hashtag_parsing - ✅ Bulk hashtag processing ✅ All operations are now sync-safe:
Uses Bear's x-callback-url API for all writes
No iCloud sync conflicts or data corruption
Respects Bear's internal sync coordination
Full write functionality restored
Perfect integration between database reads and API writes!
🔧 Troubleshooting
Common Issues "Database not found" error:
Verify Bear is installed and has been opened at least once
Check database path: ~/Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/
"Permission denied" error:
Ensure Claude Desktop has necessary file system permissions
Check that the database file is readable
Write operations not working:
Ensure Bear app is installed and has been opened at least once
Check that Bear's x-callback-url functionality is enabled
Try opening Bear manually to verify it's working
Large databases (10,000+ notes) may take longer for reads
Use specific search terms instead of broad queries
Consider using pagination with limit parameters
Getting Help
📈 Performance
Read operations : Instant (direct database access)Write operations : 1-2 seconds (Bear API processing)Large databases : Tested with 10,000+ notesMemory usage : ~50MB typical, ~100MB for complex operationsConcurrent operations : Read operations can run simultaneouslyAPI operations : Processed through Bear's URL scheme
📄 License MIT License - see LICENSE file for details.
Made with ❤️ for the Bear community
คะแนนในไดเรกทอรี 15/100 อยู่ในรายการ 10 จาก 10
อยู่ใน MCP Registry ทางการ 0 จาก 18
ผู้ดูแลอ้างสิทธิ์แล้ว 0 จาก 8
ตอบกลับพร้อมรายการเครื่องมือ 0 จาก 12
ดาวบน GitHub 9 จาก 16
ยอดดาวน์โหลดรายสัปดาห์ 0 จาก 10
Graphify Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, e Private Gpt Complete API layer for private AI applications on local models: RAG, skills, tools, MCP, text-to-sql, and more. Works with any OpenAI-compatible inference server. Scientific Agent Skills Turn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 250,000+ scientists worldwide. 177 ready-to-use validated skills plus 100+ scientific databases covering biolog Open Code Review Secure, fast, efficient, battle-tested at Alibaba's scale. Hybrid architecture code review tool: deterministic pipelines + LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, Codebase Memory Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection. Orm The Prisma ORM: write your application in TypeScript with human-readable queries instead of SQL. Host your database on Prisma Postgres and your app on Prisma Compute. OpenViking Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills. Context Mode Free, local plugin that keeps tool output out of your coding agent's context window. Sandbox and SQLite FTS5 search, 99% fewer bytes in context. Works with Claude Code, Codex, Pi, OMP, OpenCode, Gemin Dbx 25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Dock Xerj AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory a Wasp The batteries-included full-stack framework for the AI era. Develop JS/TS web apps (React, Node.js, and Prisma) using declarative code that abstracts away complex full-stack features like auth, backgr WrenAI GenBI (Generative BI) for AI agents, an open-source, governed text-to-SQL through an open context layer that turns natural-language questions into trusted dashboards, charts, and SQL across 20+ data s เซิร์ฟเวอร์ MCP หมวด Databases เซิร์ฟเวอร์ MCP ที่ดีที่สุดในหมวด Databases
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
ติดตั้ง Bear Notes อย่างไร? คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
Bear Notes ต้องใช้ API key ไหม? ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Bear Notes ใช้ทรานสปอร์ตแบบใด? Bear Notes ทำงานแบบโลคัลผ่าน stdio
Bear Notes ถูกตรวจสอบล่าสุดเมื่อใด? ตรวจสอบล่าสุดเมื่อ 2026-10-27 MCP server for Bear app - Full Read + Write AI-powered note management with Claude Desktop
เครื่องมือมีคำอธิบาย 0 จาก 6
