# mcp-bear: Integrate Bear Notes with Model Context Protocol Servers This repository profile is provided by osrepos.com, an open source repository discovery platform. Source: osrepos.com Repository profile: https://osrepos.com/repo/jkawamoto-mcp-bear Generated for open source discovery and AI-assisted research. mcp-bear is a Python-based Model Context Protocol (MCP) server designed to seamlessly integrate with Bear note-taking software. It enables powerful automation and interaction with Bear notes through various MCP clients, enhancing productivity for macOS users. This project leverages Bear's X-callback-url scheme to provide a robust set of actions. GitHub: https://github.com/jkawamoto/mcp-bear OSRepos URL: https://osrepos.com/repo/jkawamoto-mcp-bear ## Summary mcp-bear is a Python-based Model Context Protocol (MCP) server designed to seamlessly integrate with Bear note-taking software. It enables powerful automation and interaction with Bear notes through various MCP clients, enhancing productivity for macOS users. This project leverages Bear's X-callback-url scheme to provide a robust set of actions. ## Topics - bear - macos - mcp-server - python - x-callback-url - note-taking - productivity - automation ## Repository Information Last analyzed by OSRepos: Sat Feb 14 2026 00:00:37 GMT+0000 (Western European Standard Time) Detail views: 2 GitHub clicks: 5 ## Safety Notice OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything. ## Content ## Introduction `mcp-bear` is a Python-based Model Context Protocol (MCP) server designed to facilitate seamless interaction with the popular [Bear note-taking software](https://bear.app/). 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: yaml extensions: bear: name: Bear cmd: uvx args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear] envs: { "BEAR_API_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](https://block.github.io/goose/docs/getting-started/using-extensions#mcp-servers). ### For Claude Desktop Download the latest MCP bundle `mcp-bear.mcpb` from the [Releases page](https://github.com/jkawamoto/mcp-bear/releases) 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", "" ] } } } After editing, restart the application. For more information, see: [For Claude Desktop Users - Model Context Protocol](https://modelcontextprotocol.io/quickstart/user). ### For LM Studio Configure this server for LM Studio by clicking the button below: [![Add MCP Server bear to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-light.svg)](https://lmstudio.ai/install-mcp?name=bear&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2prYXdhbW90by9tY3AtYmVhciIsIm1jcC1iZWFyIiwiLS10b2tlbiIsIjxZT1VSX1RPS0VOPiJdfQ%3D%3D) ## 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](https://bear.app/faq/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. ## Links * **GitHub Repository**: [jkawamoto/mcp-bear](https://github.com/jkawamoto/mcp-bear) * **Bear App**: [bear.app](https://bear.app/) * **Bear X-callback-url Scheme Documentation**: [bear.app/faq/x-callback-url-scheme-documentation/](https://bear.app/faq/x-callback-url-scheme-documentation/) * **Goose Documentation - Using Extensions**: [block.github.io/goose/docs/getting-started/using-extensions#mcp-servers](https://block.github.io/goose/docs/getting-started/using-extensions#mcp-servers) * **Claude Desktop - Model Context Protocol Quickstart**: [modelcontextprotocol.io/quickstart/user](https://modelcontextprotocol.io/quickstart/user) * **LM Studio Deep Link for mcp-bear**: [lmstudio.ai/install-mcp?name=bear&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2prYXdhbW90by9tY3AtYmVhciIsIm1jcC1iZWFyIiwiLS10b2tlbiIsIjxZT1VSX1RPS0VOPiJdfQ%3D%3D](https://lmstudio.ai/install-mcp?name=bear&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2prYXdhbW90by9tY3AtYmVhciIsIm1jcC1iZWFyIiwiLS10b2tlbiIsIjxZT1VSX1RPS0VOPiJdfQ%3D%3D)