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.

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.

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.

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

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.

• /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.