{"name":"mcp-bear: Integrate Bear Notes with Model Context Protocol Servers","description":"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","url":"https://osrepos.com/repo/jkawamoto-mcp-bear","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/jkawamoto-mcp-bear","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/jkawamoto-mcp-bear.md","json":"https://osrepos.com/repo/jkawamoto-mcp-bear.json","topics":["bear","macos","mcp-server","python","x-callback-url","note-taking","productivity","automation"],"keywords":["bear","macos","mcp-server","python","x-callback-url","note-taking","productivity","automation"],"stars":null,"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.","content":"## Introduction\n`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.\n\n## Installation\nTo 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`.\n\n### For Goose CLI\nEdit your `~/.config/goose/config.yaml` to include the Bear extension:\nyaml\nextensions:\n bear:\n name: Bear\n cmd: uvx\n args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]\n envs: { \"BEAR_API_TOKEN\": \"\" }\n enabled: true\n type: stdio\n\n\n### For Goose Desktop\nAdd a new extension with the following settings:\n* **Type**: Standard IO\n* **ID**: bear\n* **Name**: Bear\n* **Description**: Interacting with Bear note-taking software\n* **Command**: `uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear`\n* **Environment Variables**: Add `BEAR_API_TOKEN` with your API token.\nFor more details, refer to the [Goose documentation on Using Extensions - MCP Servers](https://block.github.io/goose/docs/getting-started/using-extensions#mcp-servers).\n\n### For Claude Desktop\nDownload 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`:\n\n{\n \"mcpServers\": {\n \"bear\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\",\n \"git+https://github.com/jkawamoto/mcp-bear\",\n \"mcp-bear\",\n \"--token\",\n \"\"\n ]\n }\n }\n}\n\nAfter editing, restart the application. For more information, see: [For Claude Desktop Users - Model Context Protocol](https://modelcontextprotocol.io/quickstart/user).\n\n### For LM Studio\nConfigure this server for LM Studio by clicking the button below:\n[![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)\n\n## Examples (Implemented Actions)\nThe `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.\n\nSupported actions include:\n* `/open-note`\n* `/create`\n* `/add-text` (partially, via `replace_note` and `add_title` methods)\n* `/add-file`\n* `/tags`\n* `/open-tag`\n* `/rename-tag`\n* `/delete-tag`\n* `/trash`\n* `/archive`\n* `/untagged`\n* `/todo`\n* `/today`\n* `/locked`\n* `/search`\n* `/grab-url`\n\n## Why Use It\n`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.\n\n## Links\n* **GitHub Repository**: [jkawamoto/mcp-bear](https://github.com/jkawamoto/mcp-bear)\n* **Bear App**: [bear.app](https://bear.app/)\n* **Bear X-callback-url Scheme Documentation**: [bear.app/faq/x-callback-url-scheme-documentation/](https://bear.app/faq/x-callback-url-scheme-documentation/)\n* **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)\n* **Claude Desktop - Model Context Protocol Quickstart**: [modelcontextprotocol.io/quickstart/user](https://modelcontextprotocol.io/quickstart/user)\n* **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)","metrics":{"detailViews":2,"githubClicks":5},"dates":{"published":null,"modified":"2026-02-14T00:00:37.000Z"}}