Karakeep MCP Server

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

  1. Clone the repository:
    git clone <your-repository-url> cd hoarder-mcp-server
  2. Create a virtual environment (recommended):
    python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
  3. Install dependencies:
    pip install -r requirements.txt
  4. Configure Environment Variables:
    • Create a file named .env in the project root.
    • Add your Hoarder API key to it:
      HOARDER_API_KEY="YOUR_HOARDER_API_KEY_HERE"
    • Important: Make sure .env is listed in your .gitignore file to avoid committing secrets.
  5. Run the server locally:
    uvicorn main:app --reload --port 8000
    The server will be available at 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):

{ "action": "action_name", "parameters": { "param1": "value1", "param2": "value2" // ... action-specific parameters } }
-
security - not tested
A
license - permissive license
-
quality - not tested

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).

  1. Features
    1. Prerequisites
      1. Setup and Local Development
        1. API Usage

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            Provides a note storage system with a custom URI scheme and includes tools for adding notes and generating summaries for Tuya devices.
            Last updated -
            1
            Python
            MIT License
            • Apple
          • -
            security
            A
            license
            -
            quality
            A 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 -
            123
            16
            TypeScript
            MIT License
          • A
            security
            F
            license
            A
            quality
            This 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 -
            3
            Python
            • Apple
          • -
            security
            -
            license
            -
            quality
            Allows you to search the web using DuckDuckGo and optionally fetch and summarize content from search results.
            Last updated -
            Python

          View all related MCP servers

          ID: uqxb3bm8nn