Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOOK_CLI | No | Path to the hook CLI binary | /opt/homebrew/lib/ruby/gems/4.0.0/bin/hook |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hookmark_link | Generate a hook:// URL for a file or web URL and copy it to the clipboard. Returns the hook:// URL that Hookmark assigned to the item. Use this URL as a stable reference to the item when calling hookmark_connect. Accepts an absolute file path (e.g. '/Users/you/note.md') or any URL (e.g. 'https://example.com'). |
| hookmark_connect | Create a bidirectional hook (link) between two items. Both items must be referenced by their file path, URL, or hook:// URL. After this call, each item will appear in the other's hook list. Use hookmark_link or hookmark_frontmost to obtain hook:// URLs first. |
| hookmark_list | List all items hooked to a given file or URL. Returns one item per line in the requested format. Use format 'paths' (default) for plain paths/URLs, 'markdown' for clickable links, 'hooks' for hook:// URLs only, or 'verbose' for full details. Accepts an absolute file path, URL, or hook:// URL. Call with no item to list all Hookmark bookmarks. |
| hookmark_search | Search Hookmark bookmarks by keyword. Searches both bookmark names and URLs by default. Returns matching items, one per line. Use format 'paths' (default), 'markdown', 'hooks', or 'verbose' to control output. Use names_only to restrict the search to bookmark names only. |
| hookmark_remove | Remove a bidirectional hook between two items. Both items must be referenced by their file path, URL, or hook:// URL. This removes the link from both directions — after this call neither item will appear in the other's hook list. |
| hookmark_clone | Clone all hooks from one item onto another. Every item hooked to the source will also become hooked to the destination. The source item's hooks are not modified — this is a copy operation. Useful when duplicating a file or moving content to a new location. |
| hookmark_frontmost | Get the hook:// URL for the active document or window in the frontmost macOS application. Brings the specified application to the foreground and creates a Hookmark bookmark for whatever is currently active in that app (document, email, note, task, etc.). Returns the hook:// URL that can be used with hookmark_connect to link it to other items. Specify the app name without the '.app' suffix, e.g. 'Finder', 'Mail', 'Obsidian', 'Bear'. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |