Mcp Bear

io.github.jkawamotoPublished by GitHub account jkawamotov0.5.2Updated Oct 24, 2026

A MCP server for interacting with Bear note-taking software.

VerifiedSTDIODesktop onlyProductivity & Workflow

Overview

AI-generated overview

Lets an assistant read, create, search, tag, archive, and trash notes in the Bear note-taking app on macOS.

What you can do
A local MCP server that drives Bear note-taking software through Bear's X-callback-url scheme. Supported actions include opening a note, creating notes, adding text and files, listing tags, opening, renaming and deleting tags, listing untagged, todo, today and locked notes, searching, trashing, archiving, and grabbing a URL. It runs as a local process over stdio and is intended for desktop use.
When to use it
Use it when you want an AI assistant to work with an existing Bear note library on a Mac: capturing notes, searching them, or organizing tags. Note that the project is archived and Bear ships a native MCP server from v2.8, so this standalone server is no longer necessary for current Bear versions.
Requirements
A macOS desktop environment with Bear installed, plus a local runtime for the package (uv/uvx, or the Claude Desktop .mcpb bundle). A Bear API token must be supplied through the BEAR_API_TOKEN environment variable or the --token argument. No remote endpoint is used.
Before you install
The server requires the BEAR_API_TOKEN secret, which grants access to your Bear notes; keep it out of shared config files. Its actions can create, rename, archive, trash, and delete notes and tags, so changes affect your real note library. The project is archived and superseded by Bear's native MCP server.

Installation

In SourceWeft

  1. Open Mcp Bear in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[!NOTE] This repository is archived. As of v2.8, Bear now includes a native MCP server implementation, making this standalone server unnecessary.

Bear MCP Server

[uv] [Python Application] [pre-commit] [GitHub License]

A MCP server for interacting with Bear note-taking software.

[Bear MCP Server Icon]

Installation

[!NOTE] You'll need uv installed on your system to use uvx command.

goose

Open this link

goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN

to launch the installer, then click "Yes" to confirm the installation. Set BEAR_API_TOKEN environment variable to your api token.

Manually configuration

You can also directly edit the config file (~/.config/goose/config.yaml) to include the following entry:

yaml
extensions:  bear:    name: Bear    cmd: uvx    args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]    envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" }    enabled: true    type: stdio

For more details on configuring MCP servers in Goose, refer to the documentation: Using Extensions | goose.

Claude

Download the latest MCP bundle mcp-bear.mcpb from the Releases page, then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.

Manually configuration

You can also manually configure this server for Claude Desktop. Edit the claude_desktop_config.json file by adding the following entry under mcpServers:

json
{  "mcpServers": {    "bear": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/jkawamoto/mcp-bear",        "mcp-bear",        "--token",        "<YOUR_TOKEN>"      ]    }  }}

After editing, restart the application.

For more information, see: Connect to local MCP servers - Model Context Protocol.

LM Studio

To configure this server for LM Studio, click the button below.

[Add MCP Server bear to LM Studio]

Actions Implemented

The server supports the following actions. Refer to Bear's X-callback-url Scheme documentation for details on each action.

  • /open-note
  • /create
  • /add-text (partially, via the replace_note and add_title method)
  • /add-file
  • /tags
  • /open-tag
  • /rename-tag
  • /delete-tag
  • /trash
  • /archive
  • /untagged
  • /todo
  • /today
  • /locked
  • /search
  • /grab-url

License

This application is licensed under the MIT License. See the LICENSE file for more details.

Source: README.md at commit 14b511f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.5.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts