{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_q3q3acmnxky8","handle":"safari-bookmarks-mcp","url":"https://wellknown.network/agents/safari-bookmarks-mcp","links":{"self":"https://wellknown.network/agents/safari-bookmarks-mcp/record.json","html":"https://wellknown.network/agents/safari-bookmarks-mcp","markdown":"https://wellknown.network/agents/safari-bookmarks-mcp/record.md","api":"https://wellknown.network/api/v1/agents/safari-bookmarks-mcp","status":"https://wellknown.network/api/v1/agents/safari-bookmarks-mcp/status","claim":"https://wellknown.network/agents/safari-bookmarks-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/safari-bookmarks-mcp/claim.json","badge":"https://wellknown.network/agents/safari-bookmarks-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/safari-bookmarks-mcp/history","tools":"https://wellknown.network/api/v1/agents/safari-bookmarks-mcp/tools"},"ard":{"identifier":"urn:air::server:safari-bookmarks-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"safari-bookmarks-mcp","summary":"A CLI and MCP server to manage bookmarks in the Safari web browser.","description":"# safari-bookmarks-mcp\n\nManage Safari bookmarks through an MCP server or CLI.\n\nBuilt on [safari-bookmarks-cli](https://github.com/evilmarty/safari-bookmarks-cli) by Marty (evilmarty), extended with MCP support and modern tooling. Apache 2.0.\n\n> **macOS note:** 10.14+ requires Full Disk Access for the terminal app you're running from.\n\n## MCP server\n\nAdd to your client config — `uvx` handles installation automatically:\n\n**`.mcp.json`** (Claude Code, project scope):\n```json\n{\n  \"mcpServers\": {\n    \"safari-bookmarks\": {\n      \"command\": \"uvx\",\n      \"args\": [\"safari-bookmarks-mcp\", \"--file\", \"~/Library/Safari/Bookmarks.plist\"]\n    }\n  }\n}\n```\n\nOr use the bootstrap command to generate config for Claude Code, OpenCode, Codex, and Gemini:\n\n```shell\nuvx safari-bookmarks-mcp bootstrap --client claude --client opencode --scope local --write\n```\n\nScopes: `local` (project-level), `global` (user-level), `both`.\n\n**Server flags:**\n- `--readonly` — block all write operations\n- `--confirm-write` — allow writes (default requires `dry_run=True` per call)\n\n**Tools:** `list_bookmarks`, `search_bookmarks`, `snapshot`, `add_bookmark`, `add_folder`, `move_item`, `remove_item`, `edit_item`, `empty_folder`. All write tools accept `dry_run=True` to preview changes without saving.\n\n## CLI\n\n```shell\nuvx --from safari-bookmarks-mcp safari-bookmarks --help\n```\n\n```shell\nsafari-bookmarks list\nsafari-bookmarks list \"BookmarksMenu\"\nsafari-bookmarks add --title \"Example\" --url \"http://example.com\" \"BookmarksMenu\"\nsafari-bookmarks add --title \"New Folder\" --list \"BookmarksBar\"\nsafari-bookmarks move \"BookmarksMenu\" \"Example\" --to \"BookmarksBar\" \"New Folder\"\nsafari-bookmarks remove \"BookmarksBar\" \"New Folder\"\nsafari-bookmarks empty \"BookmarksBar\" \"New Folder\"\n```\n\nDefault file: `~/Library/Safari/Bookmarks.plist`. Override with `-f <path>`.\n\n## Development\n\n```shell\ngit clone https://github.com/chikingsley/safari-bookmarks-mcp.git\njust setup   # create .venv and install deps\njust check   # ruff + ty +…","publisher":null,"homepage":"https://github.com/chikingsley/safari-bookmarks-mcp","repository":"https://github.com/chikingsley/safari-bookmarks-mcp/issues","version":"0.6.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:safari-bookmarks-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.791,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["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":"safari-bookmarks-mcp","registry":"pypi","observedAt":"2026-11-04T00:27:12.033Z","publishedAt":"2026-02-22T06:14:56.985173Z","latestVersion":"0.6.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"safari-bookmarks-mcp","url":"https://pypi.org/project/safari-bookmarks-mcp/","firstSeenAt":"2026-09-10T11:27:40.202Z","fetchedAt":"2026-11-04T00:25:03.334Z","normalizedAt":"2026-11-04T00:25:03.334Z"}]},"firstSeenAt":"2026-09-10T11:27:40.202Z","updatedAt":"2026-11-04T00:27:12.033Z"}