[!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

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.

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.

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.

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.