Karakeep MCP server
The Karakeep MCP server lets you manage bookmarks, lists, and tags in Karakeep.
Bookmarks
Search (
search-bookmarks) — Full-text search with qualifiers (favorites, archived, tags, lists, date ranges, URL substrings, types, etc.)Get a bookmark (
get-bookmark) — Retrieve a bookmark by IDGet bookmark content (
get-bookmark-content) — Retrieve the full content of a bookmarkCreate a text bookmark (
create-text-bookmark) — Save text as a bookmark with an optional titleCreate a URL bookmark (
create-url-bookmark) — Save a URL as a bookmark with an optional titleUpdate or delete bookmarks — Modify or remove existing bookmarks
Lists
Get all lists (
get-lists) — Retrieve all available listsGet a single list — Retrieve a specific list by ID
Get bookmarks in a list (
get-bookmarks-in-list) — Retrieve bookmarks belonging to a listCreate a list (
create-list) — Create a list with a name, emoji icon, optional parent, description, query, and public flagUpdate or delete a list — Modify or remove a list
Add bookmark to a list (
add-bookmark-to-list) — Add a bookmark to a specific listRemove bookmark from a list (
remove-bookmark-from-list) — Remove a bookmark from a list
Tags
List tags — Retrieve tags with filters, pagination, and usage counts
Get a single tag — Retrieve a specific tag by ID
Rename or delete tags — Modify or remove existing tags
List bookmarks by tag — Retrieve bookmarks attached to a specific tag
Attach tags (
attach-tag-to-bookmark) — Attach one or more tags to a bookmarkDetach tags (
detach-tag-from-bookmark) — Remove one or more tags from a bookmark
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Karakeep MCP serversearch for bookmarks about machine learning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)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 schemaDeleting a list (
delete-list) — child lists are NOT deleted with the parent; they keep their parentId pointing at the deleted listAdding 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 deletedListing the bookmarks attached to a tag (
get-tag-bookmarks)Attaching and detaching tags on bookmarks (
attach-tag-to-bookmark,detach-tag-from-bookmark)
Currently, the MCP server only exposes tools (no resources).
Related MCP server: Bookmark Geni MCP Server
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"
]
}
}
}Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/karakeep-app/karakeep'
If you have feedback or need assistance with the MCP directory API, please join our Discord server