Karakeep MCP Server: Setup for Claude, Cursor and Other Apps

• Searches your saved bookmarks by keyword or meaning

  Searches your Karakeep bookmarks using full-text, semantic or hybrid search.

  Try: “Find my bookmarks about sourdough starters.”

  Network · search-bookmarks

• Opens one bookmark with its details

  Fetches a single bookmark by id, including its title, tags and content type.

  Try: “Show me the bookmark about the Rust async talk.”

  Network · get-bookmark

• Reads the saved page as plain markdown text

  Returns the content of a bookmark as markdown so the assistant can read or summarize it.

  Try: “Summarize the article I saved yesterday.”

  Network · get-bookmark-content

• Shows which lists a bookmark is in

  Lists every list that contains a given bookmark.

  Try: “Which lists is this bookmark filed under?”

  Network · get-bookmark-lists

• Saves a new link or a text note

  Creates either a link bookmark from a URL or a text bookmark from text you give it, with an optional title.

  Try: “Save https://example.com/guide as a bookmark.”

  Write · create-bookmark

• Edits a bookmark's fields

  Updates only the fields you pass on an existing bookmark and returns the updated bookmark.

  Try: “Change the title of that bookmark to 'Pasta recipes'.”

  Write · update-bookmark

• Deletes a bookmark for good

  Deletes a bookmark by id. The source says this is destructive: its highlights and assets are removed too.

  Try: “Delete the bookmark about the old conference.”

  Delete · delete-bookmark

• Lists all your lists

  Retrieves all of your Karakeep lists.

  Try: “What lists do I have?”

  Network · get-lists

• Opens one list

  Retrieves a single list by its id.

  Try: “Show me the details of my Reading list.”

  Network · get-list

• Shows the bookmarks inside a list

  Lists the bookmarks in a list. Smart lists are evaluated with their saved query.

  Try: “What is in my Recipes list?”

  Network · get-list-bookmarks

• Creates a new list

  Creates a list, which can be a manual list or a smart list defined by a query.

  Try: “Create a list called Travel 2027.”

  Write · create-list

• Changes a list's name, icon or settings

  Updates only the fields you pass, such as name, icon, description, parent, query or public status.

  Try: “Rename my Reading list to To read.”

  Write · update-list

• Deletes a list but keeps its bookmarks

  Deletes a list by id. The bookmarks stay, and child lists become top-level lists.

  Try: “Delete the Old projects list.”

  Delete · delete-list

• Puts a bookmark into a list

  Adds a bookmark to a list.

  Try: “Add that bookmark to my Recipes list.”

  Write · add-bookmark-to-list

• Takes a bookmark out of a list

  Removes a bookmark from a list without deleting the bookmark.

  Try: “Remove it from the Reading list.”

  Write · remove-bookmark-from-list

• Lists your tags with bookmark counts

  Lists tags with how many bookmarks use each, with filtering and paging.

  Try: “Which tags do I use most?”

  Network · get-tags

• Opens one tag with usage counts

  Retrieves one tag by id, including its bookmark counts.

  Try: “How many bookmarks have the tag 'python'?”

  Network · get-tag

• Lists the bookmarks that carry a tag

  Lists bookmarks that have a given tag, with paging.

  Try: “Show me everything tagged 'recipes'.”

  Network · get-tag-bookmarks

• Adds a tag to a bookmark

  Attaches a tag to a bookmark.

  Try: “Tag this bookmark with 'to-read'.”

  Write · attach-tag-to-bookmark

• Removes a tag from a bookmark

  Detaches a tag from a bookmark.

  Try: “Remove the 'draft' tag from that bookmark.”

  Write · detach-tag-from-bookmark

• Renames a tag

  Renames a tag. The server normalizes the new name.

  Try: “Rename the tag 'js' to 'javascript'.”

  Write · update-tag

• Deletes a tag but keeps the bookmarks

  Deletes a tag by id. Bookmarks that had it are kept and just lose the tag.

  Try: “Delete the unused tag 'misc'.”

  Delete · delete-tag

• Lists your highlights, newest first

  Lists highlights across all of your bookmarks, newest first.

  Try: “Show my latest highlights.”

  Network · list-highlights

• Lists the highlights on one bookmark

  Lists every highlight on a bookmark.

  Try: “What did I highlight in that article?”

  Network · get-bookmark-highlights

• Opens one highlight

  Retrieves a single highlight by id.

  Try: “Show me that highlight in full.”

  Network · get-highlight

• Highlights a passage in a saved page

  Creates a text highlight on a bookmark using character positions in the bookmark's readable content.

  Try: “Highlight the first paragraph of that bookmark.”

  Write · create-highlight

• Changes a highlight's color or note

  Updates a highlight's color or note.

  Try: “Add a note to that highlight saying 'check this'.”

  Write · update-highlight

• Deletes a highlight

  Deletes a highlight by id.

  Try: “Delete the highlight I just made.”

  Delete · delete-highlight

• Gets a temporary download link for a file

  Returns a temporary signed URL for downloading an asset, such as a saved screenshot or file, by its id.

  Try: “Give me the download link for that bookmark's screenshot.”

  Network · get-asset

Watch out for

• It can delete bookmarks and their highlights

  One tool deletes a bookmark together with its highlights and assets. Others delete lists, tags and single highlights, so back up your data first. github.com

• No read-only mode is documented

  The API key you give it decides what it can reach, and the docs do not describe a narrower key. Treat the key like your account password. github.com

• Saved page text goes to your assistant

  When it reads a bookmark it returns the page content as text to the AI app you use. Avoid asking it to read private pages if that app's data policy worries you. github.com

Security advisories