{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ydq3smz3kggz","handle":"bear-mcp","url":"https://wellknown.network/agents/bear-mcp","links":{"self":"https://wellknown.network/agents/bear-mcp/record.json","html":"https://wellknown.network/agents/bear-mcp","markdown":"https://wellknown.network/agents/bear-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bear-mcp","status":"https://wellknown.network/api/v1/agents/bear-mcp/status","claim":"https://wellknown.network/agents/bear-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bear-mcp/claim.json","badge":"https://wellknown.network/agents/bear-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bear-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bear-mcp","summary":"MCP server for Bear App — fast read-only access via direct SQLite","description":"# bear-mcp\n\nMCP server that gives LLMs fast, read-only access to your Bear notes by reading the SQLite database directly.\n\n## How it works\n\nBear stores notes in a Core Data SQLite file on disk. This server opens it read-only (`?mode=ro`) and queries it directly. No network calls, no CloudKit sync latency, no API keys. Queries against the tag index instead of scanning note content.\n\n## Why this exists\n\nThe existing Bear MCP options either go through Bear's x-callback-url scheme (slow, requires Bear to be running, macOS UI automation) or the akseyh implementation that builds SQL with string concatenation. I wanted something that's fast, read-only by design, and doesn't have SQL injection issues.\n\nLimitations:\n- **macOS only** — Bear is a macOS/iOS app, the SQLite file lives on macOS\n- **Read-only** — this server cannot create, edit, or delete notes\n- **Needs Full Disk Access** — the process reading Bear's database needs FDA granted in System Settings > Privacy & Security\n\n## Install\n\n```bash\npip install git+https://github.com/mark-liu/bear-mcp.git\n```\n\nOr run without installing:\n\n```bash\nuvx --from git+https://github.com/mark-liu/bear-mcp.git bear-mcp\n```\n\nPyPI coming soon — `pip install bear-mcp` once published.\n\n## Configure in Claude Code\n\n```bash\nclaude mcp add bear -s user -- uvx --from git+https://github.com/mark-liu/bear-mcp.git bear-mcp\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_bear_notes` | Search notes by text and/or tag (uses tag index, not text scan) |\n| `get_bear_note` | Get a specific note by UUID |\n| `list_bear_tags` | List all tags (reads ZSFNOTETAG table directly) |\n| `find_notes_by_title` | Find notes by title, exact or partial match |\n| `get_recent_notes` | Get notes modified in the last N days |\n\n## License\n\nMIT","publisher":{"name":"Mark Liu","url":null},"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:bear-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bear-mcp","registry":"pypi","observedAt":"2026-09-09T10:29:48.421Z","publishedAt":"2026-03-28T07:43:19.393215Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bear-mcp","url":"https://pypi.org/project/bear-mcp/","firstSeenAt":"2026-09-09T10:26:47.122Z","fetchedAt":"2026-09-09T10:26:47.122Z","normalizedAt":"2026-09-09T10:26:47.122Z"}]},"firstSeenAt":"2026-09-09T10:26:47.122Z","updatedAt":"2026-09-09T10:29:48.421Z"}