About Bear MCP Server
Bear MCP Server is an MCP server for interacting with the Bear note-taking app. The repository is archived because Bear 2.8 and later include a native MCP server.
Key features
- 01Calls Bear actions through x-callback-url
- 02Creates, opens and searches notes
- 03Views, renames and deletes tags
- 04Lists trashed, archived and to-do notes
Use cases
- 01Creating and searching Bear notes from an MCP client
- 02Managing Bear tags in bulk
MCP support
This project is an MCP server that exposes Bear note and tag actions to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMENote
This repository is archived. As of v2.8, Bear now includes a native MCP server implementation, making this standalone server unnecessary.
Bear MCP Server
A MCP server for interacting with Bear note-taking software.
Installation
Note
You'll need
uvinstalled on your system to useuvxcommand.
goose
Open this link
goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN
to launch the installer, then click "Yes" to confirm the installation.
Set BEAR_API_TOKEN environment variable to your api token.
Manually configuration
You can also directly edit the config file (~/.config/goose/config.yaml) to include the following entry:
extensions:
bear:
name: Bear
cmd: uvx
args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]
envs: { "BEAR_API_TOKEN": "<YOUR_TOKEN>" }
enabled: true
type: stdio
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.
Manually configuration
You can also manually configure this server for Claude Desktop.
Edit the claude_desktop_config.json file by adding the following entry under mcpServers:
{
"mcpServers": {
"bear": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-bear",
"mcp-bear",
"--token",
"<YOUR_TOKEN>"
]
}
}
}
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.
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.