Command line tool

Search, read and add to your library from Terminal or a script with the resurf command.

Install: Settings → MCP → Advanced
Command: resurf
On: Mac

Install it

Open Settings → MCP and expand Advanced.
On Terminal command, click Copy.
Paste it in Terminal and press Return.
If it says ~/.local/bin isn't on your PATH, add the line it prints to your shell file. If it says your shell still runs a different resurf, remove that one as it tells you.
Open a new Terminal window and run resurf --version.

Common commands

resurf find "words" searches and filters your captures. Start here.
resurf note --title "…" --body "…" saves a note.
resurf link <url> saves a link.
resurf file <path> saves a file.
resurf open <id> opens a capture in Resurf.
resurf read <link> prints a resurf:// link as Markdown.

Add --json for output a script can read.

What it doesn't do

The Access switches in Settings → MCP don't apply to it. Anything that can run resurf can add, organize and comment whatever the switches say.

It can't move captures to the Trash, edit a note's text, edit or delete comments, or export your library.

Questions

resurf says command not found.

Copy the Terminal command from Settings → MCP → Advanced and run it, then add ~/.local/bin to your PATH as it tells you. Open a new Terminal window afterwards.

An old resurf still runs.

Run the Terminal command again. It names the old resurf and the command that removes it, such as npm uninstall -g resurf.

Can I export my library with it?

No. The command line tool has no export command.