search_bear_notesLABSCO SUMMARY
The notes you already wrote become searchable context.
A years-deep Bear archive is mostly write-only in practice. Searching it by tag, by title and by the language of the code blocks inside is what makes an old note findable at the moment it would help.
What it is
A Python MCP server that reads the Bear app's notes on macOS. Search runs across full text, tags, titles and modification dates, and it parses fenced code blocks out of notes so snippets can be found by language.
What you get
- Full-text search across every note, and filtering by tag
- Title search, exact or partial
- Recent notes filtered by modification date
- Code blocks parsed out and categorised, so snippets are findable by language
- Kubernetes manifests located by what they are — deployment examples, service configs and the rest
- Word counts, content statistics and previews, with creation and modification dates
Requirements
macOS with Bear installed and notes in it, plus Python 3.13 or newer and uv. The client launches the server from the checkout's virtual environment. No account, no key.
Setup effort
Build from source — git clone https://github.com/netologist/mcp-bear-notes.git
USE CASES
01
Finding the snippet you know you saved
Search code blocks by programming language rather than reading the notes that contain them.
02
Digging out a config you wrote once
Locate Kubernetes deployment manifests and service configs by what they are.
03
Picking up this week's thread
Filter notes by modification date to see what you were last working in.
04
Getting to one note fast
Search titles with exact or partial matching instead of scanning the full text.
7 tools
Listed in project docs. Your client may show a different list.
get_bear_notefind_kubernetes_examplesfind_code_examplesfind_notes_by_titleget_recent_noteslist_bear_tagsBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Requires
- Python 3.13 or later
- uv
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/netologist/mcp-bear-notes.git
cd mcp-bear-notes
uv sync
source .venv/bin/activate
uv run python main.py # test the serverEdit ~/Library/Application Support/Claude/claude_desktop_config.json and add the mcpServers block
Close and reopen Claude Desktop to load the MCP server
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"bear-notes": {
"command": "<YOUR_PATH_TO_MCP_BEAR_NOTES>/.venv/bin/python",
"args": [
"<YOUR_PATH_TO_MCP_BEAR_NOTES>/main.py"
],
"env": {
"PYTHONPATH": "<YOUR_PATH_TO_MCP_BEAR_NOTES>/.venv/lib/python3.13/site-packages"
}
}
}
}
