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
This application is currently under development. A known issue exists wherea browser opens for every API call.
Bear MCP Server
A MCP server for interacting with Bear note-taking software.
Installation
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
To configure this server for Claude Desktop, edit the claude_desktop_config.json file with the following entry under
mcpServers:
After editing, restart the application. For more information, see: For Claude Desktop Users - Model Context Protocol.
Installing via Smithery
To install Bear MCP Server for Claude Desktop automatically via Smithery:
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
/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.