📌Overview

Purpose: The Bear MCP Server facilitates interaction with Bear note-taking software using a server-based architecture.

Overview: This application serves as a server that enables users to connect with Bear’s functionalities via the Model Context Protocol (MCP). It allows for seamless interactions while managing Bear notes, using straightforward commands designed for both Goose CLI and desktop interfaces.

Key Features:

Note Management: Supports actions such as opening notes, creating new notes, and managing tags, providing comprehensive control over the note-taking process.
Integration Support: Easily integrates with Goose CLI, Goose Desktop, and Claude Desktop, allowing users to configure the server based on their preferred tools and environments.

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: https://block.github.io/goose/docs/getting-started/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: https://modelcontextprotocol.io/quickstart/user

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.

/open-note
/create
/tags
/open-tag
/todo
/today
/search
/grab-url

License

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