Connects Claude to Bear notes through the app's x-callback-url scheme, exposing most of the documented actions. You get note creation, text replacement, file attachments, tag management (rename, delete, open), and queries for untagged notes, todos, locked items, and search results. Also handles trash, archive, and URL grabbing. Requires an API token and runs via uvx. Works with Claude Desktop, Goose, and LM Studio. Reach for this when you want your AI to read from and write to your Bear notes directly instead of copy-pasting between apps. The implementation covers the core Bear operations you'd need for an LLM to manage a personal knowledge base stored in Bear.
A MCP server for interacting with Bear note-taking software.
[!NOTE] You'll need
uvinstalled on your system to useuvxcommand.
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.
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.
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:
{
"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.
To configure this server for LM Studio, click the button below.
The server supports the following actions. Refer to Bear's X-callback-url Scheme documentation for details on each action.
This application is licensed under the MIT License. See the LICENSE file for more details.
BEAR_API_TOKEN*secretBear API token
csoai-org/pdf-document-mcp
xt765/mcp-document-converter
io.github.xjtlumedia/markdown-formatter
io.github.ai-aviate/better-notion
suekou/mcp-notion-server
meterlong/mcp-doc