# Linkwarden MCP for AI Agents AI Agent Connect > Linkwarden lets you manage your bookmarks and web archives through your AI agent. Instead of digging through folders, you can ask your agent to find specific links, organize collections, or pull up a saved archive. It connects your self-hosted bookmark manager to your daily workflow, making your personal knowledge base searchable and actionable via natural language. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0SGAAohxG4FmdgoofRyLqTJ3D6knHWmG0Oy36xqx/ai-agent-connect - **Tags:** bookmark-manager, web-archiving, link-organization, self-hosted, collaborative-tools, content-preservation ## Description Linkwarden turns your collection of saved links into a searchable, interactive knowledge base. Instead of wrestling with a cluttered browser bar or trying to remember which folder you stashed that specific technical white paper in, you can just ask your agent to find it. This Connector bridges the gap between your static bookmarks and your active work. It lets you move links between collections, update metadata on the fly, and grab the actual content of a page even if the original URL is dead. You get to stop acting like a digital librarian and start using your saved information as a living resource. By bringing this into the Vinkius catalog, you can connect your private Linkwarden instance to any client you already use. You'll find it's a lot faster to say "find that article on quantum computing I saved last month" than it is to manually filter through dozens of bookmarks. It handles the heavy lifting of retrieving preserved archive files and dashboard stats so you can keep your focus on the actual task at hand. You can manage your entire library through a simple conversation, making it easy to organize research, keep technical documentation handy, and preserve web content before it disappears. ## Tools ### archive_link Archive a link to trigger an update of its archive files. This ensures your saved page content stays current. ### create_collection Create a new collection in your instance. Use this to start a new folder for a specific project or topic. ### create_highlight Create or update a highlight on a link. This lets you add specific notes to a page directly through your agent. ### create_link Create a new link in your Linkwarden instance. This is how you add a new bookmark to your library via natural language. ### delete_collection Delete a collection from your Linkwarden instance. This removes the folder and all its associated bookmarks to keep your workspace clean. ### delete_highlight Delete a highlight from a saved link. Use this to remove specific notes that are no longer relevant to your research. ### auth_forgot_password Send a password reset email for your Linkwarden account. This is what you use if you get locked out of your instance. ### get_archive Retrieve an archive file by its link ID. This lets you see the saved content even if the live site is down. ### get_avatar Retrieve the user avatar image. This is useful for identifying different users in a collaborative bookmarking environment. ### get_collection Get a specific collection by its ID. Use this to see all the links and metadata inside a particular folder. ### get_config Retrieve the public runtime configuration. This helps you check your current instance settings and environment. ### get_dashboard_v1 Get your dashboard data using the v1 format. This provides a high-level overview of your saved links and activity. ### get_dashboard_v2 Get your dashboard data using the v2 format. This is the preferred way to see your current stats and activity. ### get_link_highlights Get the highlights for a specific link. This lets you quickly see your saved notes on a page without opening it. ### get_link Get a link by its ID. This is the primary way to see what a specific saved bookmark contains. ### get_logins Get your login configuration. Use this to check your authentication settings and connection status. ### import_migration Import data for migration into your instance. Use this to bring in your old bookmarks and user data from a previous setup. ### list_collections Get a full list of all your collections. This is the best way to see your entire folder structure at a glance. ### list_rss List all your current RSS subscriptions. Use this to see which feeds you are currently following. ### auth_reset_password Reset your password using a provided token. This is the standard way to regain access to your account if you are locked out. ### stream_preserved_view Stream the archived format of a saved page. This lets you view the content in a readable way without loading the original URL. ### update_collection Update a collection's details. Use this to rename folders or change their descriptions in your library. ### update_dashboard_v2 Update the layout of your dashboard v2. This helps you customize how you view your stats and activity. ### update_link Update the details of a specific link. Use this to change a bookmark's title, tags, or other metadata. ### upload_archive_for_link Upload or replace a client-side archive file for a specific link. Use this to manually update a saved page's content. ### upload_standalone_archive Upload an archive file and create a new link. This creates a new bookmark from a file you already have on your machine. ### auth_verify_email Verify a user email address. This is part of the standard account setup process for your Linkwarden instance. ### get_migration Retrieve migration data for export. This is how you move your user info and links to a new instance. ### get_preserved_token Create a short-lived preserved format URL token. This provides secure, temporary access to a specific archive. ### get_public_collection_links Retrieve links from a specific public collection. This lets you see what others have shared with you. ### get_public_collection_tags Get the tags for a public collection. This helps you see how shared resources are categorized by others. ### bulk_update_links Bulk update links with new tags or collections. This saves you from editing every bookmark individually when reorganizing. ## Prompt Examples **Prompt:** ``` Can you find that article I saved about the new coffee machine and show me the highlights? ``` **Response:** ``` I found the article **The Best Espresso Machines of 2024** in your 'Home' collection. Here are the key highlights: * **Top Pick:** Breville Barista Express * **Pros:** Easy to clean, great steam wand * **Cons:** Slightly slower heating time It mentions that the Breville is the top pick for home use. ``` **Prompt:** ``` Show me my dashboard summary. ``` **Response:** ``` Here is your current Linkwarden activity: | Metric | Value | | :--- | :--- | | **Total Links** | 150 | | **Collections** | 5 | | **Archived Content** | 120 | * **Recent Activity:** You've added 12 new links this week. ``` **Prompt:** ``` Create a new collection called 'Work Projects' and put my last 3 links in it. ``` **Response:** ``` I've created the **Work Projects** collection for you. I've also moved your most recent links (Project Alpha, Q3 Goals, and Team Sync) into that folder. ``` ## Capabilities ### Create new collections Build new folders for your links with a simple command. ### Retrieve web archives Pull up the saved content of a page even if the original site is offline. ### Update link metadata Change tags or descriptions for your bookmarks without opening a browser. ### Fetch dashboard stats Get a high-level summary of your total links and archive status. ### Bulk update bookmarks Apply new tags or move multiple links to different collections at once. ### Manage highlights Add or remove specific notes and highlights on your saved pages. ## Use Cases ### Finding lost research A researcher needs to find a specific paper from six months ago. They ask the agent to search their Linkwarden collections for "quantum physics" and retrieve the archive. ### Mass reorganization A developer wants to move all "React" tutorials into a new "Frontend" folder. They ask the agent to use `bulk_update_links` to re-categorize them. ### Quick status check A content creator wants to see how many links they've saved this month. They ask the agent to fetch their `get_dashboard_v2` data for a quick summary. ### Preserving ephemeral content A student wants to save a webpage that might disappear. They ask the agent to `archive_link` to ensure they have a permanent copy. ## Benefits - Access your web archives instantly. Use `get_archive` to view saved content even if the original website is offline. - Organize links without clicking. Use `bulk_update_links` to move dozens of bookmarks into the right collections in one go. - Keep your research organized. Use `create_collection` and `create_link` to build a structured library of sources through chat. - Review your activity easily. Use `get_dashboard_v2` to get a quick summary of your saved content and progress. - Manage notes on the fly. Use `create_highlight` to add specific insights to your saved pages without leaving your agent. ## How It Works The bottom line is you get a searchable, conversational interface for your entire web archive. 1. Subscribe to the Linkwarden MCP on Vinkius. 2. Provide your instance URL and Personal Access Token in your AI client settings. 3. Ask your agent to find, organize, or archive your links. ## Frequently Asked Questions **How does Linkwarden help my AI agent find my bookmarks?** It connects your private Linkwarden instance to your agent, allowing it to search through your collections and retrieve specific links or archives using natural language commands. **Can I use Linkwarden to see pages that have been deleted from the internet?** Yes. Because Linkwarden archives web content, your agent can use the archive tool to show you the saved version of a page even if the live URL is broken. **Is Linkwarden good for organizing research papers?** It's excellent for research. You can create specific collections for different projects and use the agent to move papers, add highlights, and retrieve archived PDFs instantly. **How do I manage my bookmarks without opening my browser?** By using this Connector, you can perform all your bookmark management—like creating folders, updating tags, and moving links—directly through your chat interface. **Can the AI agent help me move many bookmarks at once?** Yes, the agent can use the bulk update tool to move dozens of bookmarks to different collections or apply new tags to multiple links in one go. **What is the difference between a link and an archive in Linkwarden?** A link is just a saved URL, while an archive is a full copy of the webpage content saved by Linkwarden so you can read it even if the original site is offline. **Can I use Linkwarden for collaborative bookmarking?** Yes, Linkwarden supports collaborative bookmarking, and this Connector allows your agent to interact with those shared public collections to find and retrieve shared resources. **How can I see a list of all my bookmark folders?** You can use the `list_collections` tool. It will retrieve all your existing collections, allowing the AI to show you how your bookmarks are organized. **Is it possible to retrieve an archived version of a saved link?** Yes! Use the `get_archive` tool with the specific Link ID. This will fetch the preserved archive file associated with that link. **Can I create a new collection directly through the AI?** Absolutely. Use the `create_collection` tool by providing a unique ID and the collection details in the payload.