Skip to main content
Version: v0.24.0

Model Context Protocol Server (MCP)

Karakeep comes with a Model Context Protocol server that can be used to interact with it through LLMs.

Supported Tools​

  • Searching bookmarks
  • Adding and removing bookmarks from lists
  • Attaching and detaching tags to bookmarks
  • Creating new lists
  • Creating text and URL bookmarks

Usage with Claude Desktop​

From NPM:

{
  "mcpServers": {
    "karakeep": {
      "command": "npx",
      "args": [
        "@karakeep/mcp",
      ],
      "env": {
        "KARAKEEP_API_ADDR": "https://<YOUR_SERVER_ADDR>",
        "KARAKEEP_API_KEY": "<YOUR_TOKEN>"
      }
    }
  }
}

From Docker:

{
  "mcpServers": {
    "karakeep": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "KARAKEEP_API_ADDR=https://<YOUR_SERVER_ADDR>",
        "-e",
        "KARAKEEP_API_KEY=<YOUR_TOKEN>",
        "ghcr.io/karakeep-app/karakeep-mcp:latest"
      ]
    }
  }
}

Demo​

mcp-1

Adding Text Bookmarks​

mcp-2

Adding URL Bookmarks​

mcp-2