Bear MCP Server

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

<img src="icon.png" width="256" height="256" alt="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.

<details> <summary>Manually configuration</summary>

You can also directly edit the config 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": "<YOUR_TOKEN>" }
    enabled: true
    type: stdio

</details>

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.

<details> <summary>Manually configuration</summary>

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",
        "<YOUR_TOKEN>"
      ]
    }
  }
}

After editing, restart the application.

</details>

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.

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.