Linkding MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Linkding, a self-hosted bookmark manager. This server enables AI assistants like Claude to interact with your Linkding bookmarks through standardized MCP tools.

Features

🔍 Search Bookmarks - Find bookmarks by query with customizable limits
➕ Create Bookmarks - Add new bookmarks with titles, descriptions, and tags
🏷️ Manage Tags - Retrieve and work with your bookmark tags
🚀 Dual Mode Support - Run via stdio (MCP standard) or HTTP server
🐳 Docker Ready - Multi-stage Alpine-based container
🔒 Secure - Runs as non-root user with minimal dependencies

Tools Available

`search_bookmarks`

Search through your Linkding bookmarks.

Parameters:

query (string, optional): Search phrase to filter bookmarks
limit (number, optional): Maximum results to return (default: 20)

`create_bookmark`

Create a new bookmark in Linkding.

Parameters:

url (string, required): The URL to bookmark
title (string, optional): Title for the bookmark
description (string, optional): Description of the bookmark
tags (array of strings, optional): Tags to associate with the bookmark

`get_tags`

Retrieve available tags from Linkding.

Parameters:

limit (number, optional): Maximum number of tags to return (default: 50)

Installation

Prerequisites

Linkding instance running and accessible
Linkding API token (generate in your Linkding admin panel)

Option 1: Docker (Recommended)

# Pull the image
docker pull ghcr.io/chickenzord/linkding-mcp:latest

# Run in stdio mode (for MCP clients)
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

# Run in HTTP mode  
docker run --rm -p 8080:8080 \
  -e LINKDING_URL="https://your-linkding.example.com" \
  -e LINKDING_API_TOKEN="your-api-token" \
  -e BIND_ADDR=":8080" \
  ghcr.io/chickenzord/linkding-mcp:latest http

Option 2: Homebrew (macOS/Linux)

# Add the tap
brew tap chickenzord/tap

# Install linkding-mcp
brew install linkding-mcp

# Install latest development version
brew install --HEAD linkding-mcp

Option 3: Go Install

go install github.com/chickenzord/linkding-mcp/cmd/linkding-mcp@latest

Option 4: Build from Source

git clone https://github.com/chickenzord/linkding-mcp.git
cd linkding-mcp
go build -o linkding-mcp ./cmd/linkding-mcp

Configuration

Environment Variables

LINKDING_URL (required): Your Linkding instance URL
LINKDING_API_TOKEN (required): API token from your Linkding admin panel
BIND_ADDR (optional): HTTP server bind address (default: ":8080")

Getting Your Linkding API Token

Log into your Linkding instance
Go to Settings → Integrations
Generate a new API token
Copy the token for use with this MCP server

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linkding": {
      "command": "docker",
      "args": [
        "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"
      ]
    }
  }
}

Or if using a local binary:

{
  "mcpServers": {
    "linkding": {
      "command": "linkding-mcp",
      "args": ["stdio"],
      "env": {
        "LINKDING_URL": "https://your-linkding.example.com",
        "LINKDING_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code with MCP Extension

{
  "mcp.servers": [
    {
      "name": "linkding",
      "command": "linkding-mcp",
      "args": ["stdio"],
      "env": {
        "LINKDING_URL": "https://your-linkding.example.com", 
        "LINKDING_API_TOKEN": "your-api-token"
      }
    }
  ]
}

Other MCP Clients

For any MCP-compatible client, use:

Command: linkding-mcp stdio (or Docker equivalent)
Transport: stdio
Environment: Set LINKDING_URL and LINKDING_API_TOKEN

Usage Examples

Once configured with an MCP client, you can use natural language commands:

"Search for bookmarks about golang"
"Create a bookmark for https://example.com with title 'Example Site' and tags 'reference', 'tools'"
"Show me all my tags"
"Find bookmarks related to kubernetes"

Development

Running Locally

# Set environment variables
export LINKDING_URL="https://your-linkding.example.com"
export LINKDING_API_TOKEN="your-api-token"

# Run in stdio mode
go run ./cmd/linkding-mcp stdio

# Run in HTTP mode  
go run ./cmd/linkding-mcp http

Testing

# Run tests
go test ./...

# Test with a real Linkding instance
go run ./cmd/linkding-mcp stdio < test-requests.json

Building

# Build binary
go build -o linkding-mcp ./cmd/linkding-mcp

# Build Docker image
docker build -t linkding-mcp .

Docker Compose Example

version: '3.8'
services:
  linkding-mcp:
    image: ghcr.io/chickenzord/linkding-mcp:latest
    environment:
      - LINKDING_URL=https://your-linkding.example.com
      - LINKDING_API_TOKEN=your-api-token
      - BIND_ADDR=:8080
    ports:
      - "8080:8080"
    command: ["http"]

API Reference

The HTTP mode exposes MCP endpoints at:

POST /mcp/v1/initialize - Initialize MCP session
POST /mcp/v1/tools/list - List available tools
POST /mcp/v1/tools/call - Call a tool

See the MCP specification for detailed API documentation.

Troubleshooting

Common Issues

Authentication Error: Verify your LINKDING_API_TOKEN is correct and has proper permissions.

Connection Error: Ensure your LINKDING_URL is accessible and includes the protocol (https://).

Permission Denied: If running Docker, ensure the container can access your Linkding instance (check firewalls/networks).

Debug Mode

Set LINKDING_DEBUG=true for verbose logging:

LINKDING_DEBUG=true linkding-mcp stdio

Logs

Container logs:

docker logs <container-id>

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 17 Commits
.github		.github
cmd/linkding-mcp		cmd/linkding-mcp
examples		examples
internal		internal
pkg/linkding		pkg/linkding
.dockerignore		.dockerignore
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.goreleaser.yaml		.goreleaser.yaml
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
go.mod		go.mod
go.sum		go.sum

License

chickenzord/linkding-mcp

Folders and files

Latest commit

History

Repository files navigation

Linkding MCP Server

Features

Tools Available

search_bookmarks

create_bookmark

get_tags

Installation

Prerequisites

Option 1: Docker (Recommended)

Option 2: Homebrew (macOS/Linux)

Option 3: Go Install

Option 4: Build from Source

Configuration

Environment Variables

Getting Your Linkding API Token

MCP Client Configuration

Claude Desktop

VS Code with MCP Extension

Other MCP Clients

Usage Examples

Development

Running Locally

Testing

Building

Docker Compose Example

API Reference

Troubleshooting

Common Issues

Debug Mode

Logs

Contributing

License

Related Projects

Support

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 6

Packages 0

Uh oh!

Contributors 2

Uh oh!

Languages

`search_bookmarks`

`create_bookmark`

`get_tags`

Packages