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
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.
For Goose CLI
To enable the Bear extension in Goose CLI,
edit the configuration file ~/.config/goose/config.yaml to include the following entry:
For Goose Desktop
Add a new extension with the following settings:
Type: Standard IO
ID: bear
Name: Bear
Description: Interacting with Bear note-taking software
Command:
uvx --from git+https://github.com/jkawamoto/mcp-bear mcp-bearEnvironment Variables: Add
BEAR_API_TOKENwith your api token
For more details on configuring MCP servers in Goose Desktop, refer to the documentation: Using Extensions - MCP Servers.
For Claude Desktop
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: For Claude Desktop Users - Model Context Protocol.
For 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.