The Bear MCP Server allows users to interact with Bear note-taking software via API calls, providing functionality to:
Open a note by its ID or title
Create a new note with optional tags, title, and text
List all tags displayed in Bear's sidebar
Open notes associated with a specific tag
Access the Todo sidebar item with search functionality
View the Today sidebar section
Search across all notes or within a specific tag
Create a note from web page content with optional tags
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bear MCP Serversearch for meeting notes from last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bear MCP Server
A MCP server for interacting with Bear note-taking software.
Installation
You'll needuv installed on your system to use uvx command.
goose
Open this link
to launch the installer, then click "Yes" to confirm the installation.
Set BEAR_API_TOKEN environment variable to your api token.
You can also directly edit the config file (~/.config/goose/config.yaml) to include the following entry:
For more details on configuring MCP servers in Goose, refer to the documentation: Using Extensions | goose.
Claude
Download the latest MCP bundle mcp-bear.mcpb from
the Releases page,
then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.
You can also manually configure this server for Claude Desktop.
Edit the claude_desktop_config.json file by adding the following entry under mcpServers:
After editing, restart the application.
For more information, see: Connect to local MCP servers - Model Context Protocol.
LM Studio
To configure this server for LM Studio, click the button below.
Related MCP server: mcp-discord-chat MCP server
Actions Implemented
The server supports the following actions. Refer to Bear's X-callback-url Scheme documentation for details on each action.
/open-note
/create
/add-text (partially, via the replace_note and add_title method)
/add-file
/tags
/open-tag
/rename-tag
/delete-tag
/trash
/archive
/untagged
/todo
/today
/locked
/search
/grab-url
License
This application is licensed under the MIT License. See the LICENSE file for more details.