# bear-notes-mcp

> MCP Server for Bear note taking app available as Claude Desktop extension or standalone server for any other AI tool

- **URL**: https://www.freshcrate.ai/projects/bear-notes-mcp
- **Author**: vasylenko
- **Category**: MCP Servers
- **Latest version**: `v3.0.1` (2026-05-12)
- **License**: MIT
- **Source**: https://github.com/vasylenko/bear-notes-mcp
- **Homepage**: https://bear-notes-mcp.vercel.app
- **Language**: TypeScript
- **GitHub**: 181 stars, 18 forks
- **Registry**: github (`vasylenko/bear-notes-mcp`)
- **Tags**: `ai-assistant`, `bear`, `bear-notes`, `claude`, `claude-ai`, `claude-desktop`, `gtd-applications`, `mcp-bundle`, `typescript`

## Description

MCP Server for Bear note taking app available as Claude Desktop extension or standalone server for any other AI tool

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v3.0.1` | 2026-05-12 | High | ### Internal - **TypeScript upgraded from 5.9.3 to 6.0.3** — `@types/node` is now declared explicitly in `tsconfig.json` (TS6 no longer auto-loads ambient types reachable only through transitive peer deps). Hand-rolled regex escapes in `operations/notes.ts` replaced with the Stage-4 `RegExp.escape` (V8 13.6; ships with all Node 24 releases). SQL rows are now cast to typed interfaces at the query boundary instead of field-by-field. No user-facing behavior changes.  ---  Download bear-notes-mcpb-2 |
| `v3.0.0` | 2026-05-11 | High | ### Added - **Search results include matching snippets** — each result carries a short excerpt around the matched terms so you can judge relevance without opening every note. - **Plain-language errors for unprocessable search queries** — when a query can't be parsed, the response says so in plain language and points at the offending input instead of leaking a raw SQLite error. - **`bear-capabilities`** tool — when Edit Mode is off, surfaces the unlock guidance through `tools/list` so it reaches |
| `v2.12.0` | 2026-04-21 | High | ### Removed - **`bear-grab-url`** tool — removed to keep the server network-free and eliminate prompt-injection risk from fetched content.  ---  Download bear-notes-mcpb-20260421.mcpb to install the extension. |
| `v2.11.0` | 2026-04-20 | High | ### Added - **`bear-search-notes` now includes tags in results** — each search result with tags shows a `Tags:` line alongside existing metadata (title, dates, ID). This lets LLMs cross-reference tags across multiple notes without opening each one individually. ### Changed - **Soft errors now signal `isError: true` in tool responses** — for recoverable failures handled inside tool implementations (such as a missing note, handler-level parameter validation, a disabled feature, or a file error), t |
| `v2.10.0` | 2026-04-13 | Medium | ### Added - **`bear-grab-url`** tool — save a web page as a Bear note. Bear fetches the page and converts it to markdown. Supports optional comma-separated tags. The note is created in the background without bringing Bear to the foreground. ### Fixed - **Database reads no longer fail when Bear is writing** — the SQLite connection now sets a 3-second `busy_timeout`, so read queries wait briefly instead of failing instantly with "database is locked" when Bear happens to be mid-write.  ---  Downloa |
| `v2.9.0` | 2026-03-31 | Medium | ## Changed - **`bear-add-file` accepts `file_path` as alternative to `base64_content`** ([#88](https://github.com/vasylenko/bear-notes-mcp/issues/88)): When the file exists on disk, provide its path instead of base64-encoded content. The server reads and encodes the file internally, avoiding the cost of the LLM producing thousands of base64 output tokens. The `filename` parameter is auto-inferred from the path when omitted. The two input modes (`file_path` and `base64_content`) are mutually excl |
| `v2.8.2` | 2026-03-29 | Medium | ### Changed - **Repository renamed to `bear-notes-mcp`** ([#75](https://github.com/vasylenko/bear-notes-mcp/issues/75)): The project identity is now client-neutral — "Bear Notes MCP Server" instead of "Claude Desktop Extension". README, package metadata, and all repository URLs have been updated. GitHub redirects the old URL automatically, but update your bookmarks and clones when convenient. **No feature- or client-facing changes in this release**  ---  Download bear-notes-mcpb-20260329.mcpb to |
| `v2.8.1` | 2026-03-14 | Low | ### Fixed - **File attachment data no longer contaminates note body during write operations** ([#86](https://github.com/vasylenko/claude-desktop-extension-bear-notes/issues/86)): `bear-open-note` previously appended a synthetic `# Attached Files` section directly into the note text. When an AI agent then used `bear-replace-text`, this synthetic section could be written back into the note as real content. File metadata is now returned as a separate MCP content block, keeping the note body clean f |
| `v2.8.0` | 2026-03-13 | Low | ### Added - **`bear-rename-tag`** tool ([#63](https://github.com/vasylenko/claude-desktop-extension-bear-notes/issues/63)) — rename a tag across all notes in your Bear library. Useful for reorganizing tag taxonomy, fixing typos, or restructuring tag hierarchies. - **`bear-delete-tag`** tool ([#64](https://github.com/vasylenko/claude-desktop-extension-bear-notes/issues/64)) — delete a tag from all notes without affecting the notes themselves. ### Fixed - **`bear-list-tags` no longer shows ghost t |
| `v2.7.0` | 2026-03-06 | Low | ### Changed - **`bear-create-note` returns the note ID** ([#66](https://github.com/vasylenko/claude-desktop-extension-bear-notes/issues/66)): When a title is provided, the tool now polls Bear's database after creation and returns the note's unique identifier. This lets AI agents reference the newly created note in follow-up operations (add text, add tag, etc.) without a separate search step. When no title is given or the lookup times out, the tool still succeeds — returning the ID is best-effort |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 18
- **Resolved**: 18
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-05-25

## Citation

- HTML: https://www.freshcrate.ai/projects/bear-notes-mcp
- Markdown: https://www.freshcrate.ai/projects/bear-notes-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/bear-notes-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._