Bear

A MCP server for interacting with Bear note-taking software.

list-all-tags-or-retrieve-tag-details-for-bear-notes.

67

GitHub Stars

—

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jkawamoto-mcp-bear": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-bear",
        "mcp-bear"
      ],
      "env": {
        "BEAR_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

You can run a Bear MCP Server to interact with Bear note-taking software through a local MCP interface. This server exposes a set of actions you can trigger from compatible MCP clients, unlocking note manipulation, tagging, searching, and more from Bear.

How to use

To use the Bear MCP Server, start the local MCP endpoints and then connect your MCP client to the provided stdio configurations. The server implements a range of Bear actions such as opening notes, creating notes, adding text, attaching files, managing tags, trash and archive workflows, and various search-oriented endpoints. Use your MCP client to call these endpoints by the action name the client exposes (for example, open-note, create, add-text, add-file, tags, search, grab-url, etc.). You can supply token or API credentials via environment variables when the client configuration requires it.

How to install

Prerequisites: you need the Bear MCP Server runtime available on your machine. You also need a compatible MCP client to connect to these endpoints.

Additional configuration notes

The Bear MCP Server can be run as a local stdio process configured via a command and a set of arguments. Two explicit local configurations are provided for popular MCP routing flows. Each configuration uses the uvx runtime to run the Bear MCP module and passes the Bear MCP project as a source, with the Bear API token supplied via environment or token parameter.

{
  "type": "stdio",
  "name": "bear",
  "command": "uvx",
  "args": ["--from", "git+https://github.com/jkawamoto/mcp-bear", "mcp-bear"]
}

{
  "type": "stdio",
  "name": "bear",
  "command": "uvx",
  "args": ["--from", "git+https://github.com/jkawamoto/mcp-bear", "mcp-bear", "--token", "<YOUR_TOKEN>"]
}

Security and tokens

When connecting to Bear MCP Server, protect your Bear API token. Supply tokens via environment variables or as part of the configuration according to your client’s capabilities. Treat tokens as sensitive data and never expose them in logs or shared configurations.

Tools and endpoints

The Bear MCP Server provides a set of endpoints that you can call from your MCP client. These endpoints cover common Bear operations such as opening, creating, and editing notes, manipulating tags, and performing searches.

Available tools

open_note

Open an existing Bear note by its identifier or URL, returning the note content and metadata.

create

Create a new Bear note with optional title, content, and metadata.

add_text

Add or replace text in an existing Bear note, including updating the title.

add_file

Attach a file to a Bear note.

open_tag

Open notes associated with a specific tag.

rename_tag

Rename an existing tag across notes.

delete_tag

Delete a tag and dissociate it from notes.

trash

Move a note to trash or restore it from trash.

untagged

Query notes that have no tags.

todo

Manage TODO items within Bear notes.

today

Retrieve notes or tasks due today.

locked

Lock or unlock notes for editing.

search

Search within Bear notes using keywords or filters.

grab_url

Retrieve the URL or shareable link for a Bear note.