Bear Notes

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.

- Full-text searchacross all your notes
- Tag-based filteringfor organized content
- Title-based searchwith exact or partial matching
- Recent notesfiltering by modification date

- 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 documentationdiscovery

- Word countand content statistics
- Code language detectionfrom fenced code blocks
- Content previewsfor quick scanning
- Metadata extraction(creation/modification dates)

- macOS (Bear App is macOS/iOS only)
- Bear App installed and with some notes
- Python 3.8 or higher
- Claude Desktop (for desktop integration)

git clone github.com/netologist/mcp-bear-notes

Edit your Claude Desktop configuration file:

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

{ "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.

Close and reopen Claude Desktop to load the MCP server.

Once integrated with Claude Desktop, you can use natural language to interact with your Bear notes:

"Search my Bear notes for Docker examples" "Find notes about Python APIs" "Show me my recent notes from this week"

"Find my Kubernetes deployment manifests" "Look for JavaScript code examples in my notes" "Show me notes with YAML configurations"

"Get the note titled 'Development Setup'" "Find notes tagged with 'work'" "Show me all my available tags"

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

Retrieve a specific note by its unique ID.

- note_id: Bear note's unique identifier

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

find_code_examples(language, topic, limit)

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

find_notes_by_title(title_query, exact_match)

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

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

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

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

- 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

- Check Python path in configuration
- Verify virtual environment activation
- Ensure fastmcp is installed

- Verify Bear database path exists
- Check that Bear App has been opened at least once
- Confirm notes aren't in trash

- Validate JSON syntax in config file
- Check file paths are absolute, not relative
- Restart Claude Desktop after configuration changes

- Ensure script has execute permissions:chmod +x main.py
- Check Bear database file permissions

Run the server directly to see debug output:

Check Claude Desktop logs for MCP server errors:

- 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

Contributions welcome! Areas for improvement:

- Additional search filters
- Export functionality
- Note creation capabilities
- iOS Shortcuts integration
- Performance optimizations

MIT License - See LICENSE file for details.

- Initial release
- Basic search and retrieval functions
- Kubernetes and code example finders
- Claude Desktop integration
- Tag listing and filtering
- Check the troubleshooting section
- Review Claude Desktop MCP documentation
- Open an issue on GitHub
- 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.

Multi-device file sync, dev-doc CRUD, task management, and session handoffs for AI agents - MCP + OpenAPI dual surface.

Access and manage your library on Apple Books.

Interact with Apple Notes using natural language on macOS.

MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.

A server for interacting with the Bear note-taking application.

Provides direct access to your Bear notes database for comprehensive note management, bypassing standard API limitations.

Allows AI assistants to read notes from the Bear note-taking app by connecting directly to its SQLite database.

Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.

Markdown-first Notion MCP server — 26 tools, 92% fewer tokens, full round-trip fidelity

A simple notes system for Itemit, built with TypeScript.