jkawamoto

mcp-bear: Connect AI Clients to Bear Notes

mcp-bear is a Python MCP server that lets compatible AI clients interact with Bear notes through Bear’s X-callback-url actions. It is archived and is largely superseded by Bear’s built-in MCP server.

View on GitHub Compare
Stars
77
Forks
12
Stars, last 30 days
+0

Our take

Health score

33/100

How it is scored
Activity
45
Community
23
Issues
21
Pull requests
43

+0 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

77

Forks

11

Change since Nov 17, 2026: 0 stars·0 forks

Overview

mcp-bear connects MCP-compatible clients to Bear, the macOS note-taking app. It exposes selected Bear actions so an AI assistant can search, open, create, and otherwise work with notes and tags.

The project is most relevant to users who need a bridge for clients that do not use Bear’s native MCP server. The repository is archived, and Bear now includes a native implementation, so the standalone server is generally unnecessary for current setups.

Key Features

  • Provides an MCP server for interacting with Bear.
  • Supports searching for and opening notes.
  • Supports creating notes and partially adding text.
  • Offers actions for tags, including listing, opening, renaming, and deleting tags.
  • Exposes Bear actions for trash, archive, untagged, todo, today, and locked notes.
  • Supports adding files and grabbing URLs.
  • Can be configured with clients including Goose, Claude Desktop, and LM Studio.

Use Cases

  • Bear users connecting an MCP-compatible assistant to notes for search and retrieval.
  • Goose users who want to invoke Bear actions from an MCP extension.
  • Claude Desktop users who need an existing bridge to Bear, particularly with an older Bear setup.
  • Developers evaluating how Bear’s X-callback-url actions can be exposed through MCP.

Getting Started

The README describes client-specific setup. For a compatible setup using uvx, the server can be launched from the GitHub repository:

uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear --token <YOUR_TOKEN>

See the README for client configuration and details on the Bear API token.

Considerations

  • The repository is archived. Bear’s native MCP server, available as of Bear 2.8, makes this standalone server unnecessary for many users.
  • It requires Bear, a Bear API token, and uv for the documented uvx setup.
  • The /add-text action is only partially implemented, through the replace_note and add_title methods.
  • The server works through Bear’s X-callback-url actions, so its capabilities follow the supported actions listed in the README.

Found this useful?

Share it with someone who would like mcp-bear.