mcp-bear

jkawamoto/mcp-bear

3.5

If you are the rightful owner of mcp-bear and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

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

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:

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:

{
  "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 file for more details.