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

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.

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.