Skip to content
appsgit

Bear Notes MCP

Bear Notes MCP is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP Server for Bear note taking app available as Claude Desktop extension or standalone server for any other… It has 205 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y bear-notes-mcp.

github.com/vasylenko/bear-notes-mcp (opens in a new tab)

Install Bear Notes MCP

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "bear-notes-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bear-notes-mcp"
      ],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "your-value",
        "UI_ENABLE_CONTENT_REPLACEMENT": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env UI_ENABLE_NEW_NOTE_CONVENTION=your-value --env UI_ENABLE_CONTENT_REPLACEMENT=your-value --transport stdio bear-notes-mcp -- npx -y bear-notes-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "bear-notes-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bear-notes-mcp"
      ],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "your-value",
        "UI_ENABLE_CONTENT_REPLACEMENT": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "bear-notes-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bear-notes-mcp"
      ],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "your-value",
        "UI_ENABLE_CONTENT_REPLACEMENT": "your-value"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
UI_ENABLE_NEW_NOTE_CONVENTIONNoShown in the README's example configuration.
UI_ENABLE_CONTENT_REPLACEMENTNoShown in the README's example configuration.

Tools (13)

Parsed from the Tools section of the README; check the repository for the current list.

  • bear-open-note

    Read the full text content of a Bear note by its ID or title, including OCR'd text from attached images and PDFs

  • bear-create-note

    Create a new note in your Bear library with optional title, content, and tags

  • bear-search-notes

    Find notes by relevance across titles, body, and OCR-extracted text from attached images and PDFs.

  • bear-add-text

    Insert text at the beginning or end of a Bear note, or within a specific section identified by its header.

  • bear-replace-text

    Replace content in an existing Bear note — either the full body or a specific section.

  • bear-add-file

    Attach a local file (image, PDF, document) to an existing Bear note by its ID or title.

  • bear-list-tags

    List all tags in your Bear library as a hierarchical tree with note counts

  • bear-find-untagged-notes

    Find notes in your Bear library that have no tags assigned

  • bear-add-tag

    Add one or more tags to an existing Bear note. Requires the note's current revision token (the Revision: N line from…

  • bear-archive-note

    Archive a Bear note to remove it from active lists without deleting it

  • bear-rename-tag

    Rename a tag across all notes in your Bear library

  • bear-delete-tag

    Delete a tag from all notes in your Bear library without affecting the notes

  • bear-capabilities

    Report the current server mode (read-only or Edit Mode) and how to unlock additional capabilities

About Bear Notes MCP

An unofficial, opinionated MCP server for Bear Notes — built around relevance-ranked search instead of substring matching. Results come ranked across titles, bodies, and hierarchical tags, with snippets and combinable filters (tag, date, pinned). Reads run direct against Bear's SQLite database — no Bear app required for queries.

  • bear
  • claude
  • claude-desktop
  • mcp-server
  • bear-notes
  • claude-ai
  • mcp-bundle
  • notes
  • notetaking
  • productivity

FAQ

Bear Notes MCP FAQ

Still curious? Email info@appsgit.com.

What is Bear Notes MCP?

Bear Notes MCP is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP Server for Bear note taking app available as Claude Desktop extension or standalone server for any other… It has 205 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y bear-notes-mcp. The source code is at github.com/vasylenko/bear-notes-mcp.

How do I install the Bear Notes MCP MCP server?

Add the command npx -y bear-notes-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Bear Notes MCP free?

The server is open source under the Apache-2.0 license, so running it is free. It does not declare any required API key.

Is Bear Notes MCP actively maintained?

The most recent commit was on Jun 28, 2026. The latest release is v3.0.1, published May 12, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.