Karakeep MCP server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KARAKEEP_API_KEY | Yes | Your Karakeep API token | |
| KARAKEEP_API_ADDR | Yes | The address of your Karakeep server |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get-assetA | Get a temporary signed URL for downloading an asset by its asset ID. |
| search-bookmarksA | Search for bookmarks matching a specific query using full-text, semantic, or hybrid search. |
| get-bookmarkB | Get a bookmark by id. |
| get-bookmark-listsA | List every list that contains a bookmark. |
| create-bookmarkB | Create a link bookmark or a text bookmark |
| update-bookmarkA | Update fields on an existing bookmark. Only the fields you pass are modified; omitted fields stay unchanged. Returns the updated bookmark. |
| get-bookmark-contentB | Get the content of the bookmark in markdown |
| delete-bookmarkA | Delete a bookmark by id. This is destructive — the bookmark, its highlights, and its assets are removed. |
| list-highlightsA | List highlights across all bookmarks, newest first. |
| get-bookmark-highlightsA | List every highlight on a bookmark. |
| get-highlightA | Retrieve a single highlight by id. |
| create-highlightA | Create a text highlight on a bookmark using character offsets from the bookmark's readable content. |
| update-highlightB | Update a highlight's color or note. |
| delete-highlightB | Delete a highlight by id. |
| get-listsB | Retrieves a list of lists. |
| get-listB | Retrieve a single list by its id. |
| update-listA | Update a list. Only the fields you pass are changed. Length caps and smart-list query rules come from the shared list schema. |
| delete-listA | Delete a list by id. Bookmarks inside the list are not deleted. Child lists are also not deleted. Any child lists become root-level lists (their parentId is set to null). If that isn't the tree change you want, move or re-parent the children before calling this. |
| add-bookmark-to-listB | Add a bookmark to a list. |
| remove-bookmark-from-listB | Remove a bookmark from a list. |
| get-list-bookmarksA | List bookmarks in a list by its stable id. Smart lists are evaluated using their saved query. |
| create-listC | Create a list. |
| attach-tag-to-bookmarkC | Attach a tag to a bookmark. |
| detach-tag-from-bookmarkC | Detach a tag from a bookmark. |
| get-tagsA | List tags with their bookmark counts. Supports filtering and pagination. |
| get-tagA | Retrieve a single tag by id, including its bookmark counts. |
| update-tagB | Rename a tag. The new name is normalized by the server. |
| delete-tagA | Delete a tag by id. Bookmarks that had this tag are not deleted; the tag is just removed from them. |
| get-tag-bookmarksA | List bookmarks that have a given tag, with pagination. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 29 tools
Each tool targets a specific resource and action (e.g., bookmarks, lists, tags, highlights). Though some names are similar (get-list vs get-lists), descriptions clearly distinguish retrieving a single list versus all lists. No two tools appear to perform the same function.
All tool names follow a consistent verb_noun pattern using hyphens (e.g., create-bookmark, delete-list, get-tags). There are no mixed conventions or vague verbs. The pattern is predictable across all 29 tools.
With 29 tools, the server exceeds the 25-tool threshold that typically indicates an oversized surface. While the tools cover multiple related domains, the number feels heavy for an agent to navigate. A more minimal set might consolidate some list/tag bookmark interactions.
The server provides full CRUD coverage for bookmarks, lists, tags, and highlights, plus search and content retrieval. Attach/detach operations connect bookmarks to lists and tags, and deletion behavior is clearly documented. The only minor gap is the lack of explicit tag creation, but that may be implicit via attachment.