Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.raindrop.io/llms.txt

Use this file to discover all available pages before exploring further.

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Raindrop.io data in a simple and secure way.

​
Server address

Our MCP server uses Streamable HTTP transport with OAuth 2.1 authentication at the following address: 
https://api.raindrop.io/rest/v2/ai/mcp
On first connection your browser will open to authorize access to your Raindrop.io account.

​
Supported clients

https://mintcdn.com/raindropio-0c6b7ca1/GdpCiIhWcEST3eHX/assets/icon-claude.png?fit=max&auto=format&n=GdpCiIhWcEST3eHX&q=85&s=d951ff5c71ec3560329f2469f657f43a

Claude

claude.ai, Desktop, and Claude Code

ChatGPT

Plus, Pro, Business, Enterprise, Education
https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-vscode.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=b05de90e9d3c005662c9eadb3188bfc2

VS Code

GitHub Copilot
https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-cursor.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=1df8d38f4b98c0ec22c49a8759df8cfd

Cursor

AI code editor
https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-windsurf.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=8580884be9c04f116b02691b98ac817b

Windsurf

AI code editor
https://mintcdn.com/raindropio-0c6b7ca1/g7d24I8ROfahz7TM/assets/icon-zed.png?fit=max&auto=format&n=g7d24I8ROfahz7TM&q=85&s=06b8947c127b95ddc398aff6a400c0b6

Zed

Code editor (via mcp-remote bridge)

​
Other MCP clients

Hundreds of other tools now support MCP servers. You can configure them to use Raindrop.io MCP server with the following settings:
  • Command: npx
  • Arguments: -y mcp-remote https://api.raindrop.io/rest/v2/ai/mcp
  • Environment: None
For cloud-based or other hosted clients not listed on this page, please reach out to info@raindrop.io so we can enable support.

​
Available tools

The server exposes the following tools. Read-only tools only fetch data; the rest modify your library.

​
Bookmarks

ToolDescriptionRead-only
find_bookmarksFind bookmarks with filters and semantic searchYes
fetch_bookmark_contentGet full text and metadata of a bookmarkYes
find_misplaced_bookmarksDetect bookmarks that don’t fit their collectionYes
find_mistagged_bookmarksDetect bookmarks with unfitting tagsYes
create_bookmarksSave one or many URLs to the library
update_bookmarksEdit title, note, tags, collection and more
delete_bookmarksMove to Trash, or delete permanently if already in Trash

​
Collections

ToolDescriptionRead-only
find_collectionsFind collections by name or bookmark countYes
create_collectionsCreate one or many collections
update_collectionsRename, edit description, or move collections
merge_collectionsMerge source collections into a target
delete_collectionsDelete collections; their bookmarks go to Trash

​
Tags

ToolDescriptionRead-only
find_tagsFind tags by exact name or semantic searchYes
update_tagsRename or merge tags
delete_tagsRemove tags from the library

​
Highlights

ToolDescriptionRead-only
find_highlightsFind highlights across the libraryYes
create_highlightAdd a highlight to a bookmark
update_highlightEdit highlight text, note, or color
delete_highlightsDelete specific highlights

​
Account

ToolDescriptionRead-only
fetch_current_userGet profile, subscription, and library statsYes
fetch_popular_keywordsGet frequent keywords and domains across bookmarksYes

​
FAQ

Run the following in Terminal to clear saved auth info, then try again:
rm -rf ~/.mcp-auth
If the issue persists, make sure you have the latest version of Node.js installed.
Yes, at the https://api.raindrop.io/rest/v2/ai/mcp endpoint. This is the only supported transport.
Yes. You can pass your Raindrop.io API token directly in the Authorization: Bearer <your-token> header instead of using the interactive OAuth flow.
Try this configuration instead:
{
	"mcpServers": {
		"raindrop": {
			"command": "wsl",
			"args": ["npx", "-y", "mcp-remote", "https://api.raindrop.io/rest/v2/ai/mcp"]
		}
	}
}