mcp-bear: Integrate Bear Notes with Model Context Protocol Servers

Introduction

mcp-bear is a Python-based Model Context Protocol (MCP) server designed to facilitate seamless interaction with the popular Bear note-taking software. This project allows users to integrate Bear's powerful features with various MCP clients, enabling advanced automation and programmatic control over notes, tags, and other functionalities. Built for macOS, mcp-bear leverages Bear's X-callback-url scheme to provide a comprehensive set of actions.

Installation

To get started with mcp-bear, you'll typically use uvx to run the server. Installation involves configuring your preferred MCP client to point to the mcp-bear server, often requiring a BEAR_API_TOKEN.

For Goose CLI

Edit your ~/.config/goose/config.yaml to include the Bear extension:

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, refer to the Goose documentation on Using Extensions - MCP Servers.

For Claude Desktop

Download the latest MCP bundle mcp-bear.mcpb from the Releases page or manually configure by adding this entry to claude_desktop_config.json 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: For Claude Desktop Users - Model Context Protocol.

For LM Studio

Configure this server for LM Studio by clicking the button below:

Examples (Implemented Actions)

The mcp-bear server supports a wide range of actions, leveraging Bear's X-callback-url scheme. These actions allow for comprehensive control over your notes. Refer to Bear's X-callback-url Scheme documentation for detailed information on each action.

Supported actions include:

/open-note
/create
/add-text (partially, via replace_note and add_title methods)
/add-file
/tags
/open-tag
/rename-tag
/delete-tag
/trash
/archive
/untagged
/todo
/today
/locked
/search
/grab-url

Why Use It

mcp-bear offers a powerful bridge between your Bear notes and the Model Context Protocol ecosystem. By integrating Bear with MCP clients, you can automate note creation, management, and retrieval, streamlining your workflow. This is particularly useful for users who want to leverage AI tools or custom scripts to interact with their note-taking system, enhancing productivity and enabling sophisticated data management within Bear. The project's active development and clear documentation make it a reliable choice for extending Bear's capabilities.

mcp-bear: Integrate Bear Notes with Model Context Protocol Servers

Summary

Repository Info

Tags