Bear App MCP
About
Bear App MCP is a Python-based Machine Control Protocol server that provides a programming interface for Bear, a flexible writing app for notes and prose. It allows MCP-compatible clients to read, filter, and delete notes stored in Bear.
Details
- Author
- sachin-philip
- GitHub stars
- 2
- Downloads
- 207
- Categories
- Other
Jump to
- Retrieve a list of recent notes sorted by update date
- Filter notes by a specific tag using the '#' prefix
- Get a summary (first 5 lines) of any note by title
- Delete a note by title, marking it as trashed in Bear
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Bear App MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.11 and the UV package manager. In the project directory, run uv activate && uv install to install dependencies. Then add the JSON configuration snippet to your MCP client config, pointing the uv command to the bear.py file. The server will start and expose four tools.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"bear app mcp": {
"Raindrop": {
"command": "uv",
"args": [
"--directory",
"<location to project clone>",
"run",
"bear.py"
],
"env": []
}
}
}
}McpServers
{
"Raindrop": {
"command": "uv",
"args": [
"--directory",
"<location to project clone>",
"run",
"bear.py"
],
"env": []
}
}Bear App MCP
A Python-based MCP (Machine Control Protocol) interface for Bear, the beautiful, flexible writing app for notes and prose.
Features
This MCP provides the following tools to interact with Bear:
1. Get List of Notes
- Retrieve the latest notes sorted by update date
- Specify the number of notes to return
- Returns note titles with their last update timestamps
2. Get Notes by Tag
- Filter notes by a specific tag
- Returns all notes with the specified tag, sorted by update date
- Tags should include the '#' prefix (e.g., '#work')
3. Get Note Summary
- Retrieve the content of a specific note by title
- Returns the first 5 lines of the note's content
- Includes the note's last update timestamp
4. Delete Note
- Delete a specific note by title
- Marks the note as trashed in Bear
- Returns success/failure message
Prerequisites
1. Python 3.11
2. Install UV curl -LsSf https://astral.sh/uv/install.sh | sh
3. Install Dependancy uv activate && uv install
MCP Server Configuration
Add the following to your MCP config:
{
"mcpServers": {
"Raindrop": {
"command": "uv",
"args": [
"--directory",
"<location to project clone>",
"run",
"bear.py"
],
"env": {
}
}
}
}
License
MIT License - See LICENSE file for details
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
