linkding

This MCP server exposes tools to interact with your Linkding bookmarks via the MCP (Model Context Protocol) interface. It supports three main actions: searching bookmarks, creating new bookmarks, and retrieving existing tags. You can run the server in stdio mode for direct command/response interactions, or in HTTP mode if you deploy it behind a web server. With stdio, you’ll issue MCP tool calls through your MCP client and receive structured responses; with HTTP, you’ll access endpoints that map to the same underlying tools. Typical workflows include asking the AI to search for bookmarks related to a topic, adding a new bookmark with a title and tags, or listing your current tags to refine search or categorization.

Prerequisites:

• A running Linkding instance (self-hosted) with an API token generated from the admin panel.
• Docker installed on the host (recommended for ease of use). Alternatively, you can build from source or install via Homebrew as shown in the repository README.

Option A: Docker (recommended)

1. Pull and run the MCP server in stdio mode: docker pull ghcr.io/chickenzord/linkding-mcp:latest docker run --rm -i
   -e LINKDING_URL="https://your-linkding.example.com"
   -e LINKDING_API_TOKEN="your-api-token"
   ghcr.io/chickenzord/linkding-mcp:latest stdio

Option B: Local binary (if you build from source)

1. Ensure Go is installed and Linkding is accessible.
2. Build the binary: go build -o linkding-mcp ./cmd/linkding-mcp
3. Run in stdio mode: ./linkding-mcp stdio

Option C: HTTP mode (after building or using Docker image)

1. Run the server to listen on a port, e.g. 8080, and expose the Linkding credentials via environment variables: -e LINKDING_URL="https://your-linkding.example.com"
   -e LINKDING_API_TOKEN="your-api-token"
   -e BIND_ADDR=":8080"
2. Access MCP endpoints over HTTP per the MCP spec.

Environment variables:

• LINKDING_URL: URL of your Linkding instance (required)
• LINKDING_API_TOKEN: API token for Linkding (required)
• BIND_ADDR: HTTP server bind address (default is :8080 in HTTP mode) Security: When using HTTP mode, consider placing the MCP server behind an API gateway or reverse proxy and restrict access to trusted clients. If running in Docker, ensure the container has network access to your Linkding instance. The MCP tools exposed are:
• search_bookmarks: query and limit parameters
• create_bookmark: url, title, description, tags
• get_tags: limit If you need to adjust defaults, you can modify the tool call parameters in your MCP client configuration.