RELATED 01
AFFiNE MCP Server
Read, write and organise AFFiNE workspaces, docs, databases and comments from an MCP client
323GitHub stars
1.1k/wknpm downloads
62popularity score
Karakeep MCP Server
Search, save, tag and organise bookmarks, lists and highlights in a Karakeep instance
Official · Karakeep App JavaScript Local · stdio ProductivityKnowledge and memory
56 popularity score ★ 30k ↓ 1.0k/wk
Connect your client
Local (npm)
Add in one click
Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.
Or add it by command or config
It needs KARAKEEP_API_ADDR, KARAKEEP_API_KEY. Replace each <NAME> with your value.
Claude CodeTerminal
claude mcp add karakeep -e KARAKEEP_API_ADDR=<KARAKEEP_API_ADDR> -e KARAKEEP_API_KEY=<KARAKEEP_API_KEY> -- npx -y @karakeep/mcpClaude Desktopclaude_desktop_config.json
{
"mcpServers": {
"karakeep": {
"command": "npx",
"args": [
"-y",
"@karakeep/mcp"
],
"env": {
"KARAKEEP_API_ADDR": "<KARAKEEP_API_ADDR>",
"KARAKEEP_API_KEY": "<KARAKEEP_API_KEY>"
}
}
}
}Cursor~/.cursor/mcp.json
{
"mcpServers": {
"karakeep": {
"command": "npx",
"args": [
"-y",
"@karakeep/mcp"
],
"env": {
"KARAKEEP_API_ADDR": "<KARAKEEP_API_ADDR>",
"KARAKEEP_API_KEY": "<KARAKEEP_API_KEY>"
}
}
}
}VS Code.vscode/mcp.json
{
"servers": {
"karakeep": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@karakeep/mcp"
],
"env": {
"KARAKEEP_API_ADDR": "<KARAKEEP_API_ADDR>",
"KARAKEEP_API_KEY": "<KARAKEEP_API_KEY>"
}
}
}
}Codex~/.codex/config.toml
[mcp_servers.karakeep]
command = "npx"
args = ["-y", "@karakeep/mcp"]
[mcp_servers.karakeep.env]
KARAKEEP_API_ADDR = "<KARAKEEP_API_ADDR>"
KARAKEEP_API_KEY = "<KARAKEEP_API_KEY>"Gemini CLITerminal
gemini mcp add --scope user -e KARAKEEP_API_ADDR=<KARAKEEP_API_ADDR> -e KARAKEEP_API_KEY=<KARAKEEP_API_KEY> karakeep npx -- -y @karakeep/mcpSettings 3
KARAKEEP_API_ADDR |
Required: Address of your Karakeep server, e.g. https://cloud.karakeep.app. |
|---|---|
KARAKEEP_API_KEY |
Required: API key from your Karakeep settings page. |
KARAKEEP_CUSTOM_HEADERS |
Optional: JSON object of extra HTTP headers sent to the server, e.g. Cloudflare Access client id and secret. |
What it does
The Karakeep MCP Server connects an assistant to Karakeep, the bookmark manager, so it can work with your saved data. It can search bookmarks and read their content, create text and URL bookmarks, update and delete them, and manage lists (including smart lists), tags and highlights. It can also get temporary signed download links for stored assets. The server only offers tools; it exposes no resources.
It is published by the Karakeep project from the apps/mcp folder of the main Karakeep repository, as the npm package @karakeep/mcp and the container image ghcr.io/karakeep-app/karakeep-mcp.
To use it you need a Karakeep instance, either self-hosted or the hosted cloud.karakeep.app, and an API key from your Karakeep settings page. The address of the instance and the key are passed as environment variables. Extra HTTP headers can be added, for example Cloudflare Access credentials when the instance sits behind Cloudflare Access.
What it needs
| Runtime | Node.js |
|---|
Tools 29
search-bookmarks- Search bookmarks
get-bookmark- Read a bookmark
get-bookmark-content- Read a bookmark's content
get-bookmark-lists- List the lists that contain a bookmark
create-bookmark- Create a text or URL bookmark
update-bookmark- Update a bookmark
delete-bookmark- Delete a bookmark
get-lists- List all lists
get-list- Retrieve a single list
create-list- Create a list
update-list- Update a list's name, icon, description, parent, query or public flag
delete-list- Delete a list; child lists are not deleted
get-list-bookmarks- List bookmarks in manual and smart lists
add-bookmark-to-list- Add a bookmark to a list
remove-bookmark-from-list- Remove a bookmark from a list
get-tags- List tags with filters and pagination
get-tag- Retrieve a single tag with usage counts
update-tag- Rename a tag
delete-tag- Delete a tag; bookmarks that had it are kept
get-tag-bookmarks- List the bookmarks attached to a tag
attach-tag-to-bookmark- Attach a tag to a bookmark
detach-tag-from-bookmark- Detach a tag from a bookmark
get-asset- Get a temporary signed download URL for an asset
list-highlights- List highlights across all bookmarks
get-bookmark-highlights- List highlights for a bookmark
get-highlight- Retrieve a single highlight
create-highlight- Create a highlight
update-highlight- Update a highlight
delete-highlight- Delete a highlight