karakeep

name: karakeep

description: Save bookmarks to Karakeep (self-hosted bookmark manager). Use when the user wants to save a URL, bookmark a link, or add something to their reading list.

Save bookmarks to a self-hosted Karakeep instance.

Setup

Set these environment variables (in your shell profile or Clawdbot config):


export KARAKEEP_URL="https://your-karakeep-instance.com"

export KARAKEEP_API_KEY="your-api-key"

To get your API key: Karakeep → Settings → API Keys → Create new key.

Save a bookmark


{baseDir}/scripts/save.sh "<URL>" ["optional note"]

Examples:


{baseDir}/scripts/save.sh "https://example.com/article"

{baseDir}/scripts/save.sh "https://github.com/repo" "Interesting project to check out"

API Details

Endpoint: POST {KARAKEEP_URL}/api/v1/bookmarks
Auth: Bearer token
Body: {"type": "link", "url": "...", "note": "..."}

Response

Returns JSON with bookmark ID. Tags will be auto-generated by Karakeep's AI.