Skip to main content
Glama
samcrudge

bearnotes-mcp

by samcrudge

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_notesA

Search non-trashed notes by title/body, optionally filtered to a tag (matches the tag and its nested subtags). Empty query = most recent. Returns id, title, tags, pinned, modified.

read_noteA

Return a note's {id, title, text, tags, pinned, todo_open, todo_done}.

list_tagsA

List every tag with the number of non-trashed notes it holds.

get_backlinksA

Bear's [[wiki-link]] graph for a note: backlinks (notes linking TO it) and links_to (notes it links to). Trashed notes excluded.

create_noteB

Create a new note (its title becomes the H1 line). No token required.

append_noteA

Append text to the end of an existing note.

prepend_noteB

Prepend text to a note (Bear inserts it just after the title line).

replace_noteA

Overwrite a note's ENTIRE text, including its title line — pass the full text as returned by read_note (not body-only), or the title changes.

Backs up the current text first to ~/.bear-mcp-backups/. Note the backup is a read-only DB snapshot and may lag edits still open unsaved in Bear's UI.

toggle_taskA

Check/uncheck one checkbox line in a note, found by substring match. done=None flips it, True checks, False unchecks. Errors if match is ambiguous (rather than guessing). Backs the note up first.

open_noteB

Open and focus a note in the Bear app window.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
notes_indexIndex of recent non-trashed notes as `- title (id)` lines.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/samcrudge/bearnotes-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server