# Raindrop.io MCP > Raindrop.io (Bookmarks) connects your saved web links, collections, and tags to any AI client. You use this server to manage your entire digital reading list through natural conversation—no more clicking through tabs or fighting with folder structures. Create new bookmarks, merge tag groups, delete old collections, or empty trash, all by simply telling your agent what you need done. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** bookmarks, web-clipping, organization, knowledge-base, raindrop ## Description You connect your Raindrop.io account to any AI client, and you'll manage every link you save straight from a chat window. You don't gotta click through tabs or fight with folder structures anymore; just tell your agent what you need done. **Managing Your Links (Bookmarks)** You can treat your bookmark library like a database. Need to save one thing? Use `create_raindrop` to drop a single link into your collection. Got twenty links from an article and wanna dump 'em all at once? You run `create_many_raindrops`. If a link is stale or you just don't need it, running `delete_raindrop` handles that specific bookmark, or if you gotta clear out a bunch of junk fast, `delete_many_raindrops` gets the job done. When something changes—like an article updates its meta data—you can call `update_raindrop` to fix it, and you'll use `update_many_raindrops` if you gotta change tags or metadata for a whole bunch of links at once. **Structuring Your Folders (Collections)** The server lets you build out your digital filing cabinet. You start by pulling a list of all top-level folders using `list_root_collections`. Then, if you need a new topic area, you run `create_collection` to make that single folder. If you're building out deep research material, you can check the subfolders inside any parent with `list_child_collections`, and then create those nested sections too. You can modify an existing folder's name or structure using `update_collection`. Wanna group two separate topics into one big umbrella? Just run `merge_collections` to combine them. If a whole collection is dead weight, you delete it with `delete_collection`. And when you mess up, don't sweat it; you can check the contents and metadata of any folder using `get_collection`. **Controlling Tags (Taxonomy)** Tags keep everything clean. You pull a list of every tag applied to your entire library using `list_tags`. If two tags mean the same thing—like 'AI' and 'Artificial Intelligence'—you can run `rename_merge_tags` to combine them into one neat category. Wanna dump useless labels? Use `delete_tags` to remove tags that nobody uses anymore. You also use tags for filtering, so you get a list of available options for any collection using `list_filters`, and the system keeps track of all tags applied across your entire set of links. **Retrieval and Viewing History** You can check what's in any specific folder by running `list_raindrops` on it, which handles sorting and trash views. If you just want to see everything saved—every single highlight you've bookmarked across every collection and tag—you call `list_all_highlights`. For a deep dive into one area, you can list all highlights specific to one folder using `list_collection_highlights`. You can pull the full details of any individual link with `get_raindrop`, or get info on what's sitting in your trash by checking `list_raindrops` while viewing the trash. **System Cleanup and Account Info** Need to keep things tidy? When you’re done experimenting, you can use `empty_trash` to permanently wipe out every item currently marked for deletion. You can see how much of your data is protected by checking `list_backups`, or if you need to adjust the credentials connected to your agent, you run `update_user`. The server also lets you pull basic public info about your account via `get_public_user` and gives you authenticated details through `get_user`. Finally, you can update those user details using `update_user`. ## Tools ### create_collection Creates a single new folder (collection) for your bookmarks. ### create_many_raindrops Adds multiple specified links to your bookmark library at once. ### create_raindrop Saves a single web link as a new bookmark (raindrop). ### delete_collection Deletes an entire collection of bookmarks. ### delete_many_raindrops Removes multiple specified bookmarks from your library in a single action. ### delete_raindrop Deletes a specific bookmark (raindrop). ### delete_tags Removes tags that are no longer needed for organization. ### empty_trash Permanently deletes all items currently sitting in your trash folder. ### get_collection Retrieves the details and contents of a single specified collection. ### get_public_user Gets publicly available information about your Raindrop.io account. ### get_raindrop Retrieves the content and metadata for a single bookmark. ### get_user Gets authenticated details about your connected Raindrop.io user account. ### list_all_highlights Lists every highlight you have saved across all collections and tags. ### list_backups Shows a list of your available data backups. ### list_child_collections Retrieves a list of subfolders within a parent collection. ### list_collection_highlights Lists all highlights saved specifically inside one specified collection. ### list_filters Shows which filtering options are available for a given collection. ### list_raindrops Lists all bookmarks found within a specific collection, handling sorting and trash views. ### list_root_collections Retrieves the names and IDs of all top-level folders in your library. ### list_tags Shows you all the tags currently applied across your entire bookmark system. ### merge_collections Combines two or more specified collections into a single new folder. ### rename_merge_tags Renames an existing tag, or merges it with another tag to keep your taxonomy clean. ### update_collection Modifies the name or structure of an existing collection folder. ### update_many_raindrops Applies a bulk update (like changing tags) to multiple selected bookmarks at once. ### update_raindrop Modifies the metadata or content of a single existing bookmark. ### update_user Changes details about your connected Raindrop.io account. ## Prompt Examples **Prompt:** ``` List all my top-level bookmark collections. ``` **Response:** ``` I've retrieved your root collections. You have: 'Unsorted' (ID: 0), 'Work' (ID: 12345), and 'Personal' (ID: 67890). Which one would you like to explore? ``` **Prompt:** ``` Save https://mcp.io to my 'Research' collection with the tag 'ai'. ``` **Response:** ``` Successfully created a new raindrop for 'mcp.io' in your 'Research' collection (ID: 55443) with the tag 'ai'. ``` **Prompt:** ``` Empty my trash collection. ``` **Response:** ``` I have permanently deleted all items in your Trash collection. ``` ## Capabilities ### Manage Links (Bookmarks) Create, update, and delete individual bookmarks, handling single or bulk link operations. ### Organize Folders (Collections) List root collections, create subfolders, merge existing folders, or delete them entirely. ### Control Tags Manage content classification by listing tags, renaming groups of tags, merging redundant tags, or deleting unused ones. ### View and Clear History Retrieve all saved highlights, list backups, and permanently empty the trash collection when you're done with old links. ## Use Cases ### The Overwhelmed Researcher A researcher just saved 50 links on climate science. Instead of manually creating 10 folders, they ask the agent: 'Create a root collection called Climate Research and move all related bookmarks into it.' The agent runs `create_collection` followed by multiple update tools, organizing the data in seconds. ### The Project Manager A PM needs to group resources from two separate meetings. They ask: 'Merge my 'Meeting A' collection and my 'Ideas' collection into a new folder called 'Q3 Planning'. The agent uses `merge_collections`.' This saves hours of manual file reorganization. ### The Technical Writer A writer has saved articles tagged 'UX Design' and 'Wireframing.' They realize they should be one category. They tell the agent: 'Merge tags 'UX Design' and 'Wireframing' into 'Product UI'. The agent runs `rename_merge_tags`, cleaning up their system taxonomy. ### The Developer Doing Cleanup A developer finished a project and has 30 old links in the trash. They simply type: 'Empty my trash collection.' The agent executes `empty_trash`, guaranteeing no forgotten or unnecessary data remains. ## Benefits - Stop losing links in deep folder structures. Use the `list_root_collections` tool to instantly see your top-level organization, making navigation immediate. - Clean up messy taxonomies fast. The `rename_merge_tags` tool lets you merge two tags—say, 'AI' and 'Machine Learning'—into one clean tag without losing any content. - Process research data in batches. Instead of adding links one by one, use `create_many_raindrops` to dump a list of 50 articles into a new project folder instantly. - Keep your system tidy and secure. Use the `empty_trash` tool when you're done with old references, permanently removing items without manual file deletion. - Maintain structural integrity with bulk edits. The `update_many_raindrops` tool lets you change a tag or add notes to dozens of bookmarks at once. ## How It Works The bottom line is that it turns your private link library into a conversational resource for your agent. 1. Subscribe to this server on Vinkius Marketplace. 2. Input your Raindrop.io Personal Access Token into the connection settings. 3. Your AI client now treats your entire bookmark library as an accessible tool, allowing you to issue commands like 'Create a collection called Project Alpha' or 'Delete all tags related to finance.' ## Frequently Asked Questions **How do I create new collections using the Raindrop.io (Bookmarks) MCP Server?** You use the `create_collection` tool. Just ask your agent to 'Create a new collection named Project Nova.' It runs the command and makes the folder available immediately. **Can I bulk update links using the Raindrop.io (Bookmarks) MCP Server?** Yes, you can run `update_many_raindrops`. This lets you apply a single change—like adding a new tag or changing the description—to dozens of bookmarks without touching them one by one. **What does list_root_collections do?** It shows all your top-level folders. If you want to see what major categories you have, just ask it to `list_root_collections`. It gives you the starting point for any search. **If I delete a tag, is the bookmark still usable?** Yes. Deleting a tag with `delete_tags` only removes the classification label. The actual link and its content remain safe in the bookmark's collection. **How do I use `list_all_highlights` to see every annotation I've saved?** The `list_all_highlights` function gathers all your saved highlights across every collection. This is the quickest way to get a global view of your annotations without having to filter by location. **What does running the `empty_trash` tool actually do?** The `empty_trash` function permanently deletes all items in your Trash collection. Use this when you are certain that none of the removed links or bookmarks need to be recovered, as there is no undo. **How can I fix overlapping tags using `rename_merge_tags`?** `rename_merge_tags` lets you combine duplicate tags across your entire library. This keeps your content taxonomy clean and prevents links from being managed under inconsistent or redundant labels. **What information does the `get_user` tool provide about my account?** The `get_user` function returns your authenticated Raindrop.io user profile details. You can use this to confirm which specific account you're managing or retrieve associated metadata. **Can I organize my bookmarks into nested folders using this integration?** Yes. You can use `list_root_collections` to see top-level folders and `list_child_collections` to see nested ones. You can also create new collections with `create_collection`. **Is it possible to delete multiple bookmarks at once?** Absolutely. The `delete_many_raindrops` tool allows your agent to remove a list of bookmark IDs in a single operation. **How can I see the highlights I've made on my saved pages?** You can use the `list_all_highlights` tool to retrieve all highlights across your entire account, or `list_collection_highlights` for a specific collection.