{
  "markdown": "> [!NOTE]\n> This repository is archived. As of [v2.8](https://blog.bear.app/2026/04/bear-2-8-bearcli-claude-connector-and-mcp-server/),\n> Bear now includes a\n> native [MCP server implementation](https://bear.app/faq/command-line-interface/),\n> making this standalone server unnecessary.\n\n# Bear MCP Server\n[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)\n[![Python Application](https://github.com/jkawamoto/mcp-bear/actions/workflows/python-app.yaml/badge.svg)](https://github.com/jkawamoto/mcp-bear/actions/workflows/python-app.yaml)\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)\n[![GitHub License](https://img.shields.io/github/license/jkawamoto/mcp-bear)](https://github.com/jkawamoto/mcp-bear/blob/main/LICENSE)\n\nA MCP server for interacting with [Bear](https://bear.app/) note-taking software.\n\n<img src=\"icon.png\" width=\"256\" height=\"256\" alt=\"Bear MCP Server Icon\">\n\n## Installation\n> [!NOTE]\n> You'll need [`uv`](https://docs.astral.sh/uv) installed on your system to use `uvx` command.\n\n### [goose](https://block.github.io/goose/)\nOpen this link\n```\ngoose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN\n```\nto launch the installer, then click \"Yes\" to confirm the installation.\nSet `BEAR_API_TOKEN` environment variable to your api token.\n\n<details>\n<summary>Manually configuration</summary>\n\nYou can also directly edit the config file (`~/.config/goose/config.yaml`) to include the following entry:\n\n```yaml\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\": \"<YOUR_TOKEN>\" }\n    enabled: true\n    type: stdio\n```\n\n</details>\n\nFor more details on configuring MCP servers in Goose, refer to the documentation:\n[Using Extensions | goose](https://block.github.io/goose/docs/getting-started/using-extensions#mcp-servers).\n\n### [Claude](https://claude.com/download)\nDownload the latest MCP bundle `mcp-bear.mcpb` from\nthe [Releases](https://github.com/jkawamoto/mcp-bear/releases) page,\nthen open the downloaded `.mcpb `file or drag it into the Claude Desktop's Settings window.\n\n<details>\n<summary>Manually configuration</summary>\n\nYou can also manually configure this server for Claude Desktop.\nEdit the `claude_desktop_config.json` file by adding the following entry under `mcpServers`:\n\n```json\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        \"<YOUR_TOKEN>\"\n      ]\n    }\n  }\n}\n```\nAfter editing, restart the application.\n\n</details>\n\nFor more information,\nsee: [Connect to local MCP servers - Model Context Protocol](https://modelcontextprotocol.io/docs/develop/connect-local-servers).\n\n### [LM Studio](https://lmstudio.ai/)\nTo configure this server for LM Studio, click the button below.\n\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## Actions Implemented\n\nThe server supports the following actions.\nRefer to Bear's [X-callback-url Scheme documentation](https://bear.app/faq/x-callback-url-scheme-documentation/) for details on each action.\n\n- [x] /open-note\n- [x] /create\n- [x] /add-text (partially, via the replace_note and add_title method)\n- [x] /add-file\n- [x] /tags\n- [x] /open-tag\n- [x] /rename-tag\n- [x] /delete-tag\n- [x] /trash\n- [x] /archive\n- [x] /untagged\n- [x] /todo\n- [x] /today\n- [x] /locked\n- [x] /search\n- [x] /grab-url\n\n## License\nThis application is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n",
  "bytes": 4116,
  "sha": "c4528d7ac0c22056905f1747600bfc617bb8bb86e34de0701087afd50bc6f104",
  "repo_slug": "jkawamoto/mcp-bear",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jkawamoto_mcp_bear_33748dbf/readme"
}