What is Mcp Bear

mcp-bear is a MCP server designed for interacting with Bear note-taking software, allowing users to perform various actions related to note management.

Use cases

Use cases for mcp-bear include automating note-taking tasks, integrating Bear with other applications, and enhancing productivity by managing notes programmatically.

How to use

To use mcp-bear, configure it in your application (Claude Desktop or Goose CLI) by editing the respective configuration files to include the server details and your Bear API token. After configuration, restart the application to enable the server.

Key features

Key features include actions such as opening notes, creating new notes, managing tags, searching notes, and handling to-do items. It supports a range of Bear’s X-callback-url actions.

Where to use

undefined

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
• [x] /add-text (partially, via the replace_note method)
• [ ] /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.