Integrations
Used for environment variable configuration to securely store the Hoarder API key.
Mentioned as a potential hosting platform for deploying the MCP server.
Used for version control in the setup process.
Karakeep (Hoarder) MCP Server
This project provides a Mind Control Panel (MCP) compatible server that allows interactions (searching and creating bookmarks) with the Karakeep bookmarking service via its API.
It's designed to be used by Large Language Models (LLMs) or other clients capable of making HTTP requests according to the MCP protocol defined by services like Glama.ai.
Features
- Search Bookmarks: Find existing bookmarks in Karakeep based on a query string.
- Create Bookmarks: Add new bookmarks to Karakeep with a URL and optional title/description.
- MCP Compatible Endpoint: Exposes a single
/mcp
endpoint for actions. - Environment Variable Configuration: Securely configure your Hoarder API key.
Prerequisites
- Python 3.8+
- A Karakeep account and API Key (See Karakeep API Docs)
- Access to a hosting platform (e.g., Render, Heroku, Fly.io, VPS) or Docker for deployment.
Setup and Local Development
- Clone the repository:Copy
- Create a virtual environment (recommended):Copy
- Install dependencies:Copy
- Configure Environment Variables:
- Create a file named
.env
in the project root. - Add your Hoarder API key to it:Copy
- Important: Make sure
.env
is listed in your.gitignore
file to avoid committing secrets.
- Create a file named
- Run the server locally:The server will be available atCopy
http://127.0.0.1:8000
. The--reload
flag automatically restarts the server when code changes are detected.
API Usage
The server exposes a single POST endpoint: /mcp
.
Request Body (JSON):
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Search for and create bookmarks in Karakeep (Hoarder).
Related MCP Servers
- -securityAlicense-qualityProvides a note storage system with a custom URI scheme and includes tools for adding notes and generating summaries for Tuya devices.Last updated -1PythonMIT License
- -securityAlicense-qualityA very simple vector store that provides capability to watch a list of directories, and automatically index all the markdown, html and text files in the directory to a vector store to enhance context.Last updated -12316TypeScriptMIT License
- AsecurityFlicenseAqualityThis server enables users to store, manage, and summarize notes using a custom URI scheme, with functionality to add new notes and generate summaries with varying levels of detail.Last updated -3Python
- -security-license-qualityAllows you to search the web using DuckDuckGo and optionally fetch and summarize content from search results.Last updated -Python