Bear MCP Server

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

Installation

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

For Goose CLI

To enable the Bear extension in Goose CLI, edit the configuration file ~/.config/goose/config.yaml to include the following entry:

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

For Goose Desktop

Add a new extension with the following settings:

• Type: Standard IO
• ID: bear
• Name: Bear
• Description: Interacting with Bear note-taking software
• Command: uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear
• Environment Variables: Add BEAR_API_TOKEN with your api token

For more details on configuring MCP servers in Goose Desktop, refer to the documentation: Using Extensions - MCP Servers.

For Claude Desktop

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

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

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

After editing, restart the application. For more information, see: For Claude Desktop Users - Model Context Protocol.

For LM Studio

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

Actions Implemented

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

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

License

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