Our take
- Activity
- 45
- Community
- 23
- Issues
- 21
- Pull requests
- 43
+0 stars in the last 30 days
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
77Forks
11Change since Nov 17, 2026: 0 stars·0 forks
Overview
mcp-bear connects MCP-compatible clients to Bear, the macOS note-taking app. It exposes selected Bear actions so an AI assistant can search, open, create, and otherwise work with notes and tags.
The project is most relevant to users who need a bridge for clients that do not use Bear’s native MCP server. The repository is archived, and Bear now includes a native implementation, so the standalone server is generally unnecessary for current setups.
Key Features
- Provides an MCP server for interacting with Bear.
- Supports searching for and opening notes.
- Supports creating notes and partially adding text.
- Offers actions for tags, including listing, opening, renaming, and deleting tags.
- Exposes Bear actions for trash, archive, untagged, todo, today, and locked notes.
- Supports adding files and grabbing URLs.
- Can be configured with clients including Goose, Claude Desktop, and LM Studio.
Use Cases
- Bear users connecting an MCP-compatible assistant to notes for search and retrieval.
- Goose users who want to invoke Bear actions from an MCP extension.
- Claude Desktop users who need an existing bridge to Bear, particularly with an older Bear setup.
- Developers evaluating how Bear’s X-callback-url actions can be exposed through MCP.
Getting Started
The README describes client-specific setup. For a compatible setup using uvx, the server can be launched from the GitHub repository:
uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bear --token <YOUR_TOKEN>
See the README for client configuration and details on the Bear API token.
Considerations
- The repository is archived. Bear’s native MCP server, available as of Bear 2.8, makes this standalone server unnecessary for many users.
- It requires Bear, a Bear API token, and
uvfor the documenteduvxsetup. - The
/add-textaction is only partially implemented, through thereplace_noteandadd_titlemethods. - The server works through Bear’s X-callback-url actions, so its capabilities follow the supported actions listed in the README.
Found this useful?
Share it with someone who would like mcp-bear.