Linkwarden MCP server
io.github.flumpiey/linkwarden-mcp·v0.1.6·1 starsRead-first Linkwarden bookmarks MCP with opt-in write, delete, and collection tools.
1 stars30 downloads/wk
Reviews
Write oneNobody has reviewed Linkwarden MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Linkwarden MCP tools (31, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
align_tags_with_similar_linksSuggest tags used on similar-domain links already in the library.
analyze_collection_overlapCompare two collections for shared domains, tags, and URLs.
apply_triage_planauto_tag_by_domainbulk_sort_by_rulescreate_collectionwrite actiondelete_collectionwrite actiondelete_linkswrite actiondelete_tagswrite actionfind_duplicate_linksGroup links with the same normalized URL (scan capped at 500).
find_unsorted_linksList unsorted links (default: Unorganized; scan capped at 500).
get_library_overviewSummarise library totals, empty collections, and unused tags.
get_linkGet full metadata for one link.
get_sorting_dashboardOne-shot triage dashboard: unsorted, duplicates, empty, largest.
list_collectionsList collections with link counts.
list_resourceslist_tagsList tags with link counts.
merge_tagsorganise_linksqueue_archiveread_link_contentRead preserved plain text for a link (textContent or archive fallback).
recommend_collection_for_linksConsensus collection recommendation for a batch of links.
save_linksearch_linksSearch saved links by query, collection, tag, or pin status.
smart_save_linksuggest_collection_for_urlSuggest top collections for a URL (heuristic; read-only).
suggest_collection_structureHygiene report: empty collections, near-duplicate names, overcrowded.
suggest_links_for_collectionFind links elsewhere that likely belong in a collection.
suggest_tags_for_linkSuggest existing-library tags for a link or URL (never invents new names).
triage_linksPropose collection/tags for link ids (bulk-capped; no writes).
update_linkwrite action
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 65 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Linkwarden MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 31
- the typical server has 7
- Tools that change things
- 16%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 30
- more than 18% of 12,191 servers with a package
What its tools let an agent do: 23 read · 2 create · 2 change · 3 delete · 1 run or deploy
Install Linkwarden MCP in Claude Code, Cursor or VS Code
claude mcp add linkwarden-mcp -- uvx linkwarden-mcp
What the publisher says
From the Linkwarden MCP repository's README, as published. We do not edit it. Read it on GitHub
linkwarden-mcp
<!-- mcp-name: io.github.flumpiey/linkwarden-mcp -->
MCP server for self-hosted Linkwarden: ask your AI about bookmarks, collections, and tags.
What is Linkwarden?
Linkwarden is a self-hosted, open-source bookmark manager. You collect, organize, annotate, and preserve webpages in one place, with full-page archives so content stays readable after the original page disappears. It also supports collaboration and public sharing.
This project wires the Linkwarden HTTP API into the Model Context Protocol so Cursor, Claude, VS Code Copilot, and other MCP hosts can query your live library in natural language.
Useful Linkwarden links:
- Documentation
- GitHub
- Cloud
- Demo
- Self-hosting setup
What this server does
Default is read-only. You get:
- 18 read tools - discovery (list_resources), six core reads (search, get, preserved content, collections, tags, overview), and eleven triage/hygiene workflows
- Task tools (opt-in) - intent-shaped writes such as savelink, smartsavelink, organiselinks, createcollection, applytriage_plan (register when matching write scopes are set)
- Delete tools (opt-in) - deletelinks, deletetags, mergetags, deletecollection (register only under delete scopes; never implied by write)
- Hard denylist - tokens, session, auth, user admin (except GET /api/v1/users/me), migration, and whole-instance preservation stay blocked even when writes are on
Transport is stdio. No HTTP server. No global install required if you use uv / uvx.
Branding / icons
Four surfaces (keep them in sync when the mark changes):
- stdio hosts (Cursor, Claude Desktop via mcp.json): serverInfo.icons from servericons() — embedded data URI from src/linkwardenmcp/assets/icon.png, plus HTTPS fallback docs/icon-512.png (https://raw.githubusercontent.com/flumpiey/linkwarden-mcp/main/docs/icon-512.png). website_url is https://linkwarden.app/.
- Cursor plugin: .cursor-plugin/plugin.json logo → docs/linkwarden-icon.svg.
- Claude Desktop Extension: mcpb/icon.png (packed with npx @anthropic-ai/mcpb pack mcpb).
- Claude.ai remote connectors: Claude.ai ignores serverInfo.icons and uses the root-domain favicon of the connector URL. If you host a remote MCP later, serve docs/favicon.ico at the registrable domain root (e.g. https://acme.com/favicon.ico for https://mcp.acme.com/...).
server.json registry metadata also points its icons[0].src at the same raw docs/icon-512.png URL.
Requirements
- Python ≥ 3.10 (pulled in automatically by uvx)
- uv (provides uvx)
- A reachable Linkwarden instance: LINKWARDENAPIURL + LINKWARDENAPIKEY
Access token
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Linkwarden MCP: common questions
- Is Linkwarden MCP server safe?
- Mostly: it is graded B (78/100). Read the Linkwarden MCP safety report
- How do I install Linkwarden MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Linkwarden MCP need an API key?
- Yes. The registry entry asks for
LINKWARDEN_API_KEY. - Is Linkwarden MCP maintained?
- The last commit was 69 days ago (2026-08-27). The latest release is v0.1.6.
- How does Linkwarden MCP compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 31 (the typical server has 7); tools that change things 16% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.