linkwarden-mcp-server

A Model Context Protocol (MCP) server that provides AI assistants with programmatic access to Linkwarden instances. Linkwarden is a self-hosted bookmark management service, and this MCP server enables AI agents to interact with Linkwarden's bookmark collections, links, and search functionality.

Features

• Collection Management: Create, read, and delete collections with full API support
• Link Management: Create, read, archive, and delete links with comprehensive functionality
• Tag Management: Get all tags and delete tags by ID
• Advanced Search: Search links with powerful filtering and pagination
• Public Collection Access: Access public collections and their metadata
• Toolset Selectivity: Enable only the tools you need
• Read-Only Mode: Optional safety mode for production environments
• Flexible Configuration: Support for command-line flags, environment variables, and config files

Demo

Claude Code

Available Tools

Few Example Usage

Save link:

Search Link:

Installation

Prerequisites

• Access to a Linkwarden instance (self-hosted or cloud)
• Linkwarden API token with appropriate permissions

A. Using Docker (Recommended)

The easiest way to use linkwarden-mcp-server is via Docker. Pre-built images are available on GitHub Container Registry.

Pull the latest image

docker pull ghcr.io/irfansofyana/linkwarden-mcp-server:latest

Pull a specific version

# Pull a specific version (e.g., v1.0.0)
docker pull ghcr.io/irfansofyana/linkwarden-mcp-server:1.0.0

# Or with 'v' prefix
docker pull ghcr.io/irfansofyana/linkwarden-mcp-server:v1.0.0

Available tags:

• latest - Latest stable release from main branch
• v{major}.{minor}.{patch} - Specific version (e.g., v1.0.0)
• {major}.{minor}.{patch} - Specific version without 'v' prefix (e.g., 1.0.0)
• {major}.{minor} - Latest patch for minor version (e.g., 1.0)
• {major} - Latest minor and patch for major version (e.g., 1)

B. Build from Source

If you prefer to build from source:

git clone https://github.com/irfansofyana/linkwarden-mcp-server.git
cd linkwarden-mcp-server
make build

Prerequisites for building:

• Go 1.23 or later
• Make

C. Using Go Install

go install github.com/irfansofyana/linkwarden-mcp-server/cmd/linkwarden-mcp-server@latest

Configuration

The server can be configured using command-line flags, environment variables, or a configuration file.

Required Configuration

• --base-url: Your Linkwarden instance URL (or LINKWARDEN_BASE_URL environment variable)
• --token: Your Linkwarden API token (or LINKWARDEN_TOKEN environment variable)

Optional Configuration

• --toolsets: Comma-separated list of toolsets to enable (default: all)
• --read-only: Enable read-only mode (disables write operations)
• --log-file: Path to log file

Examples

Command Line Flags

./linkwarden-mcp-server \
  --base-url https://your-linkwarden-instance.com \
  --token your-api-token-here \
  --toolsets search,collection,link,tags

Environment Variables

export LINKWARDEN_BASE_URL=https://your-linkwarden-instance.com
export LINKWARDEN_TOKEN=your-api-token-here
export TOOLSETS=search,collection,link,tags
./linkwarden-mcp-server

Available Toolsets

Collection Toolset

Read Operations:

• get_all_collections: Retrieve all collections
• get_collection_by_id: Get specific collection details
• get_public_collections_links: Get links from public collections
• get_public_collections_tags: Get tags from public collections
• get_public_collection_by_id: Get public collection by ID

Write Operations:

• create_collection: Create new collections

... View full README on GitHub