Back to Karakeep

Model Context Protocol Server (MCP)

docs/versioned_docs/version-v0.29.0/09-mcp.md

0.31.01.1 KB
Original Source

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:

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

From Docker:

json
{
  "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

Search

Adding Text Bookmarks

Adding URL Bookmarks