BearSAFE
A MCP server for interacting with Bear note-taking software.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[!NOTE] This repository is archived. As of v2.8, Bear now includes a native MCP server implementation, making this standalone server unnecessary.
[](https://github.com/astral-sh/uv) [](https://github.com/jkawamoto/mcp-bear/actions/workflows/python-app.yaml) [](https://github.com/pre-commit/pre-commit) [](https://github.com/jkawamoto/mcp-bear/blob/main/LICENSE)
A MCP server for interacting with Bear note-taking software.
Installation
[!NOTE] You'll need `uv` installed on your system to use uvx command.goose
Open this link
goose://extension?cmd=uvx&arg=--from&arg=git%2Bhttps%3A%2F%2Fgithub.com%2Fjkawamoto%2Fmcp-bear&arg=mcp-bear&id=bear&name=Bear&description=Interacting%20with%20Bear%20note-taking%20software&env=BEAR_API_TOKEN
to launch the installer, then click "Yes" to confirm the installation. Set BEAR_API_TOKEN environment variable to your api token.
Manually configuration
You can also directly edit the config file (~/.config/goose/config.yaml) to include the following entry:
extensions:
bear:
name: Bear
cmd: uvx
args: [--from, git+https://github.com/jkawamoto/mcp-bear, mcp-bear]
envs: { "BEAR_API_TOKEN": "" }
enabled: true
type: stdioFor more details
6f3147a9aaf7OBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcp-bear --env BEAR_API_TOKEN=${BEAR_API_TOKEN} -- uvx mcp-bear{
"mcpServers": {
"mcp-bear": {
"command": "uvx",
"args": [
"mcp-bear"
],
"env": {
"BEAR_API_TOKEN": "${BEAR_API_TOKEN}"
}
}
}
}Exposed tools (7)
6 read · 0 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
delete_tag | destructive | Delete an existing tag. |
locked | read | Select the Locked sidebar item. |
open_tag | read | Show all the notes which have a selected tag in bear. |
tags | read | Return all the tags currently displayed in Bear’s sidebar. |
today | read | Select the Today sidebar item. |
todo | read | Select the Todo sidebar item. |
untagged | read | Select the Untagged sidebar item. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (2 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (7)
delete_tag
.mcpbignore
.pre-commit-config.yaml
callback_url = (queries.get("x-success") or [""])[0]cmd, args[0], args[1], f"{callback_url}?{urlencode(mock_exec.stubbed_queries, quote_via=quote)}"callback_url = (queries.get("x-error") or [""])[0]return await original_exec(cmd, args[0], args[1], f"{callback_url}?{urlencode(params, quote_via=quote)}")Gates applied: no_behavioural_pass.
6f3147a9aaf7full audit observations/trust-audit/mcp-server/jkawamoto__bear.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 6f3147a9aaf7 | SAFE | B | 89 | first audit |
Questions
What is the Bear MCP server?
A MCP server for interacting with Bear note-taking software.
What tools does Bear expose?
7 in total: 6 read-only, 0 that write, and 1 that can delete or overwrite (delete_tag). Every one is listed on this page with its risk.
Is Bear safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Bear need?
It reads BEAR_API_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Bear run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as mcp-bear.
How current is this page?
The grade is for one exact copy of the source (6f3147a9aaf7), read on 2026-10-07. The repository is watched and re-audited when it changes.