[!IMPORTANT] This application is currently under development. A known issue exists where a browser opens for every API call.

Bear MCP Server

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

Installation

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": "<YOUR_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

To configure this server for Claude Desktop, edit the claude_desktop_config.json file with the following entry under mcpServers:

{
  "mcpServers": {
    "youtube-transcript": {
      "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: For Claude Desktop Users - Model Context Protocol.

Installing via Smithery

To install Bear MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jkawamoto/mcp-bear --client claude

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
• [ ] /add-text
• [ ] /add-file
• [x] /tags
• [x] /open-tag
• [ ] /rename-tag
• [ ] /delete-tag
• [ ] /trash
• [ ] /archive
• [ ] /untagged
• [x] /todo
• [x] /today
• [ ] /locked
• [x] /search
• [x] /grab-url

License

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