3.0.1npm · bear-notes-mcp · current release
Observed 2026-08-14T19:03:54.430Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.
{
"tools": {
"listChanged": true
}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
bear-capabilitiesReport the current Bear Notes MCP server mode and how to unlock additional capabilities. Call this when the user asks what you can do with their Bear notes, when a write operation appears unavailable, or when the user wants to enable note creation, editing, or tag management.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"idempotentHint": true,
"openWorldHint": false
} | — | Read only · — | — |
bear-find-untagged-notesFind notes in your Bear library that have no tags. Useful for organizing and categorizing notes. Trashed and archived notes are not included.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"limit": {
"description": "Maximum number of results (default: 50, min: 1)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
}
}Annotations{
"readOnlyHint": true,
"idempotentHint": true,
"openWorldHint": false
} | — | Read only · — | — |
bear-list-tagsList all tags in your Bear library as a hierarchical tree. Shows tag names with note counts. Useful for understanding your tag structure and finding tags to apply to untagged notes. Counts include only active notes (trashed and archived are excluded). Tags with zero active notes are not shown.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"idempotentHint": true,
"openWorldHint": false
} | — | Read only · — | — |
bear-open-noteRead the full text content of a Bear note by its ID or title. Supports direct title lookup as an alternative to searching first. Always includes text extracted from attached images and PDFs (aka OCR search) with clear labeling.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"description": "Note identifier (ID) for an existing Bear note. Either id or title must be provided.",
"type": "string"
},
"title": {
"description": "Exact note title for direct lookup (case-insensitive). Either id or title must be provided. If multiple notes share the same title, returns a list for disambiguation.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"idempotentHint": true,
"openWorldHint": false
} | — | Read only · — | — |
bear-search-notesSearch your Bear notes for words or phrases. The search looks across note titles, body content, and OCR text in attached images and PDFs, returning matching notes ranked by relevance with a snippet of the matching context — so you can see what matched without opening the note. For best results, search with a phrase or several words from what you're looking for; a single word also works. Also supports filtering by tag, by creation/modification date range, or by pinned status — combine these with a search term, or use them on their own to browse without searching. Trashed and archived notes are not included.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"term": {
"description": "Words to search for. Results are ranked by relevance — notes covering more of what you typed rank higher. Pass natural keywords for the typical case (e.g., \"quarterly planning notes\"). Hyphenated or punctuated identifiers like \"bear-notes-mcp\" or \"2026-04-15\" are matched as a phrase when used alone; in multi-word queries they are treated like any other word.",
"type": "string"
},
"tag": {
"description": "Tag to filter notes by (leading # is stripped if present)",
"type": "string"
},
"limit": {
"description": "Maximum number of results to return (default: 30, min: 1)",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"createdAfter": {
"description": "Filter notes created on or after this date. Supports: relative dates (\"today\", \"yesterday\", \"last week\", \"start of last month\"), ISO format (YYYY-MM-DD). Use \"start of last month\" for the beginning of the previous month.",
"type": "string"
},
"createdBefore": {
"description": "Filter notes created on or before this date. Supports: relative dates (\"today\", \"yesterday\", \"last week\", \"end of last month\"), ISO format (YYYY-MM-DD). Use \"end of last month\" for the end of the previous month.",
"type": "string"
},
"modifiedAfter": {
"description": "Filter notes modified on or after this date. Supports: relative dates (\"today\", \"yesterday\", \"last week\", \"start of last month\"), ISO format (YYYY-MM-DD). Use \"start of last month\" for the beginning of the previous month.",
"type": "string"
},
"modifiedBefore": {
"description": "Filter notes modified on or before this date. Supports: relative dates (\"today\", \"yesterday\", \"last week\", \"end of last month\"), ISO format (YYYY-MM-DD). Use \"end of last month\" for the end of the previous month.",
"type": "string"
},
"pinned": {
"description": "Set to true to return only pinned notes: if combined with tag, will return pinned notes with that tag, otherwise only globally pinned notes.",
"type": "boolean"
}
}
}Annotations{
"readOnlyHint": true,
"idempotentHint": true,
"openWorldHint": false
} | — | Read only · — | — |