Linkwarden MCP Server

Name: Linkwarden MCP Server
Author: io.github.ni-c

io.github.ni-c/linkwarden-mcp

Repository Registry

What is the Linkwarden MCP server?

MCP server for Linkwarden, the self-hosted bookmark manager with page preservation

How to install Linkwarden

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

LINKWARDEN_URL
required
Base URL of the Linkwarden instance, e.g. https://links.example.net (without /api/v1)
LINKWARDEN_TOKEN
required
secret
Access token from Settings -> Access Tokens
LINKWARDEN_READ_ONLY
Set to true to register only the 11 read tools and no write tools
LINKWARDEN_INSECURE_TLS
Set to true to accept self-signed certificates for this connection only

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linkwarden-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "linkwarden-mcp"
      ],
      "env": {
        "LINKWARDEN_URL": "<YOUR_LINKWARDEN_URL>",
        "LINKWARDEN_TOKEN": "<YOUR_LINKWARDEN_TOKEN>",
        "LINKWARDEN_READ_ONLY": "<YOUR_LINKWARDEN_READ_ONLY>",
        "LINKWARDEN_INSECURE_TLS": "<YOUR_LINKWARDEN_INSECURE_TLS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "linkwarden-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "linkwarden-mcp"
      ],
      "env": {
        "LINKWARDEN_URL": "<YOUR_LINKWARDEN_URL>",
        "LINKWARDEN_TOKEN": "<YOUR_LINKWARDEN_TOKEN>",
        "LINKWARDEN_READ_ONLY": "<YOUR_LINKWARDEN_READ_ONLY>",
        "LINKWARDEN_INSECURE_TLS": "<YOUR_LINKWARDEN_INSECURE_TLS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "linkwarden-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "linkwarden-mcp"
      ],
      "env": {
        "LINKWARDEN_URL": "<YOUR_LINKWARDEN_URL>",
        "LINKWARDEN_TOKEN": "<YOUR_LINKWARDEN_TOKEN>",
        "LINKWARDEN_READ_ONLY": "<YOUR_LINKWARDEN_READ_ONLY>",
        "LINKWARDEN_INSECURE_TLS": "<YOUR_LINKWARDEN_INSECURE_TLS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "linkwarden-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "linkwarden-mcp"
      ],
      "env": {
        "LINKWARDEN_URL": "<YOUR_LINKWARDEN_URL>",
        "LINKWARDEN_TOKEN": "<YOUR_LINKWARDEN_TOKEN>",
        "LINKWARDEN_READ_ONLY": "<YOUR_LINKWARDEN_READ_ONLY>",
        "LINKWARDEN_INSECURE_TLS": "<YOUR_LINKWARDEN_INSECURE_TLS>"
      }
    }
  }
}

Claude Code

claude mcp add linkwarden-mcp --env LINKWARDEN_URL=<YOUR_LINKWARDEN_URL> --env LINKWARDEN_TOKEN=<YOUR_LINKWARDEN_TOKEN> --env LINKWARDEN_READ_ONLY=<YOUR_LINKWARDEN_READ_ONLY> --env LINKWARDEN_INSECURE_TLS=<YOUR_LINKWARDEN_INSECURE_TLS> -- npx -y linkwarden-mcp