A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full text search
Karakeep MCP Server
This is the Karakeep MCP server, which is a server that can be used to interact with Karakeep from other tools.
Supported Tools
Bookmarks
- Searching bookmarks (
search-bookmarks) - Reading a bookmark (
get-bookmark,get-bookmark-content) - Listing the lists that contain a bookmark (
get-bookmark-lists) - Creating text and URL bookmarks (
create-bookmark) - Updating a bookmark (
update-bookmark) - Deleting a bookmark (
delete-bookmark)
Lists
- Listing all lists (
get-lists) - Retrieving a single list (
get-list) - Creating a list (
create-list) - Updating a list (
update-list) — name, icon, description, parentId, query, public; field constraints (length caps, smart-query validation) are inherited from the shared schema - Deleting a list (
delete-list) — child lists are NOT deleted with the parent; they become root-level lists - Listing bookmarks in manual and smart lists (
get-list-bookmarks) - Adding and removing bookmarks from lists (
add-bookmark-to-list,remove-bookmark-from-list)
Tags
- Listing tags with filters / pagination (
get-tags) - Retrieving a single tag with usage counts (
get-tag) - Renaming a tag (
update-tag) - Deleting a tag (
delete-tag) — bookmarks that had the tag are not deleted - Listing the bookmarks attached to a tag (
get-tag-bookmarks) - Attaching and detaching tags on bookmarks (
attach-tag-to-bookmark,detach-tag-from-bookmark)
Assets
- Getting a temporary signed download URL for an asset (
get-asset)
Highlights
- Listing highlights across all bookmarks (
list-highlights) - Listing highlights for a bookmark (
get-bookmark-highlights) - Retrieving a single highlight (
get-highlight) - Creating, updating, and deleting highlights (
create-highlight,update-highlight,delete-highlight)
Currently, the MCP server only exposes tools (no resources).
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>",
"KARAKEEP_CUSTOM_HEADERS": "{\"CF-Access-Client-Id\": \"...\", \"CF-Access-Client-Secret\": \"...\"}"
}
}
}
}
From Docker:
{
"mcpServers": {
"karakeep": {
"command": "docker",
"args": [
"run",
"-e",
"KARAKEEP_API_ADDR=https://<YOUR_SERVER_ADDR>",
"-e",
"KARAKEEP_API_KEY=<YOUR_TOKEN>",
"-e",
"KARAKEEP_CUSTOM_HEADERS={\"CF-Access-Client-Id\": \"...\", \"CF-Access-Client-Secret\": \"...\"}",
"ghcr.io/karakeep-app/karakeep-mcp:latest"
]
}
}
}