](https://github.com/vasylenko/bear-notes-mcp/actions/workflows/ci.yml) [

Bear Notes MCP Server

Search, read, create, and update your Bear Notes from any AI assistant. Available as a one-click Claude Desktop extension and as a standalone npm package for any MCP client.

This local-only MCP server reads Bear's SQLite database for fast search with OCR support, and uses Bear's native API for writes. Complete privacy: no external connections, all processing on your Mac.

Example prompts:

Summarize our conversation and create a new Bear note with it

Interview me about my side project idea and capture the key points in a Bear note

Help me restructure the outline in my "Product Launch" note

Let's brainstorm blog post ideas — save the best ones to my Bear note and refine them as we go

✨ Key Features

• 12 MCP tools for searching, reading, creating, updating, tagging, and archiving notes
• OCR search — finds text inside attached images and PDFs
• Date-based search with relative dates ("yesterday", "last week", "start of last month")
• Tag management — list tags as a tree, find untagged notes, add tags to notes
• New note convention (opt-in) — place tags right after the title instead of at the bottom
• Content replacement (opt-in) — replace the full note body or a specific section
• Local-only — no network calls, all data stays on your Mac

[!NOTE] Complete privacy (except the data you send to your AI provider when using an AI assistant, of course): this server makes no external connections. All processing happens locally on your Mac using Bear's own database and API. There is no extra telemetry, usage statistics or anything like that.

📦 Installation

Claude Desktop Extension

Prerequisites: Bear app must be installed and Claude Desktop must be installed.

1. 1.Download the latest bear-notes-mcpb.mcpb extension from Releases
2. 2.Make sure your Claude Desktop is running (start if not)
3. 3.Doubleclick on the extension file – Claude Desktop should show you the installation prompt

If doubleclick does not work for some reason, then open Claude -> Settings -> Extensions -> Advanced Settings -> click "Install Extension".

1. 1.DONE!

Ask Claude to search your Bear notes with a query like "Search my Bear notes for 'meeting'" - you should see your notes appear in the response!

Standalone MCP Server

Want to use this Bear Notes MCP server with Claude Code, Cursor, Codex, or other AI assistants?

Requirements: Node.js 24.13.0+

#### Claude Code (one command)

claude mcp add bear-notes --transport stdio -- npx -y bear-notes-mcp@latest

#### Other AI Assistants