Mentioned as a platform where Bear App is available, though the MCP server focuses on accessing notes via the macOS database.
Provides specialized search functionality to find Kubernetes manifests and configurations stored in Bear notes.
Integrates with the Bear App on macOS to access the app's note database, allowing for searching and retrieving notes across the Bear ecosystem.
Accesses Bear's SQLite database directly to retrieve notes and their metadata for searching and analysis.
Bear App MCP Server
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.
Features
🔍 Search & Discovery
Full-text search across all your notes
Tag-based filtering for organized content
Title-based search with exact or partial matching
Recent notes filtering by modification date
💻 Code & Technical Content
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 documentation discovery
📊 Content Analysis
Word count and content statistics
Code language detection from fenced code blocks
Content previews for quick scanning
Metadata extraction (creation/modification dates)
Installation
Prerequisites
macOS (Bear App is macOS/iOS only)
Bear App installed and with some notes
Python 3.8 or higher
Claude Desktop (for desktop integration)
Setup Steps
Clone or download the server script
git clone github.com/netologist/mcp-bear-notesCreate a virtual environment
uv install source .venv/bin/activateTest the server
uv run python main.py
Claude Desktop Integration
Configuration File Location
Edit your Claude Desktop configuration file:
Add MCP Server Configuration
Important: Replace /full/path/to/
with your actual file paths.
Restart Claude Desktop
Close and reopen Claude Desktop to load the MCP server.
Usage Examples
Once integrated with Claude Desktop, you can use natural language to interact with your Bear notes:
Basic Search
Technical Content
Specific Retrieval
Available Tools
search_bear_notes(query, tag, limit)
Search notes by content and tags.
query
: Text to search fortag
: Filter by specific tag (without #)limit
: Max results (default: 20)
get_bear_note(note_id)
Retrieve a specific note by its unique ID.
note_id
: Bear note's unique identifier
find_kubernetes_examples(resource_type)
Find Kubernetes-related content.
resource_type
: K8s resource (deployment, service, etc.)
find_code_examples(language, topic, limit)
Search for code examples.
language
: Programming languagetopic
: Code topic/domainlimit
: Max results (default: 15)
find_notes_by_title(title_query, exact_match)
Search notes by title.
title_query
: Title text to searchexact_match
: Exact or partial matching
get_recent_notes(days, limit)
Get recently modified notes.
days
: How many days to look back (default: 7)limit
: Max results (default: 20)
list_bear_tags()
List all tags found in your notes.
Bear Database Information
The server reads from Bear's SQLite database located at:
Database Access Notes
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
Troubleshooting
Common Issues
Server won't start
Check Python path in configuration
Verify virtual environment activation
Ensure fastmcp is installed
No notes found
Verify Bear database path exists
Check that Bear App has been opened at least once
Confirm notes aren't in trash
Claude Desktop integration fails
Validate JSON syntax in config file
Check file paths are absolute, not relative
Restart Claude Desktop after configuration changes
Permission denied errors
Ensure script has execute permissions:
chmod +x main.py
Check Bear database file permissions
Debug Mode
Run the server directly to see debug output:
Log Files
Check Claude Desktop logs for MCP server errors:
Security & Privacy
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
Contributing
Contributions welcome! Areas for improvement:
Additional search filters
Export functionality
Note creation capabilities
iOS Shortcuts integration
Performance optimizations
License
MIT License - See LICENSE file for details.
Changelog
v1.0.0
Initial release
Basic search and retrieval functions
Kubernetes and code example finders
Claude Desktop integration
Tag listing and filtering
Support
For issues and questions:
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.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Model Context Protocol server that provides Claude with access to search, retrieve, and analyze notes from the Bear App through natural language queries.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides DuckDuckGo search functionality for Claude, enabling web search capabilities through a clean tool interface with rate limiting support.Last updated -133462MIT License
- -securityAlicense-qualityA Model Context Protocol server that allows AI assistants like Claude to read notes from the Bear note-taking app in a safe, read-only mode.Last updated -313MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude to perform advanced web research with intelligent search queuing, enhanced content extraction, and deep research capabilities.Last updated -391MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that enables Claude to persistently store, search, and manage text memories with tags in a local JSON file.Last updated -148