Bear App MCP

What is Bear App MCP?

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.

How to use Bear App MCP?

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.

Key features of Bear App MCP

• 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

Use cases of Bear App MCP

• Quickly see your most recently updated notes without opening Bear
• Find all notes tagged with a project or category (e.g., #work)
• Read a note’s opening lines before deciding to open it fully
• Remove unwanted notes programmatically from your MCP workflow

FAQ from Bear App MCP

What is Bear App MCP?

It is a Python-based MCP (Machine Control Protocol) server that lets you interact with the Bear note‑taking app. It provides tools to list, filter, read summaries, and delete notes.

What are the prerequisites?

Python 3.11 and the UV package manager are required. Install UV with curl -LsSf https://astral.sh/uv/install.sh | sh.

How do I install the dependencies?

After cloning the project, run uv activate && uv install in the project directory.

How do I configure the MCP server?

Add the following JSON to your MCP configuration, replacing <location to project clone> with the actual path:

{
  "mcpServers": {
    "Raindrop": {
      "command": "uv",
      "args": [
        "--directory",
        "<location to project clone>",
        "run",
        "bear.py"
      ],
      "env": {}
    }
  }
}

Which tools does Bear App MCP provide?

It provides four tools: get a list of notes, get notes by tag, get a note summary (first 5 lines), and delete a note.